Re: [nl-documentatie] RE: Helppagina in de offline help en de verwijzing in menu Help naar de documentatiepagina

Op do 23 mei 2024 om 17:20 schreef Henk van der Burg <h.vdburg@hccnet.nl>:

> Hallo Cor,
>
> De link in het Help-menu verwijst naar:
> https://documentation.libreoffice.org/nl/documentatie-in-het-nederlands/
>
> De recente Nederlandstalige handleidingen staan vermeld op:
> https://nl.libreoffice.org/hulp/documentatie/.

Ik heb hiervoor lang geleden een verzoek gedaan op Bugzilla. Maar dit zal
geen prioriteit hebben.


> Deze pagina is gekoppeld aan de gepubliceerde hoofdstukken op Nextcloud:
> https://nextcloud.documentfoundation.org/apps/files/?dir=/LibreOffice%20Documentation/Dutch/Handleidingen&fileid=109409
>
> V.w.b. je verwijzingen/links naar de bugpagina het volgende:
> Ik kan niet bepalen wat goed is of wat fout is. Dit wil ik illustreren met
> een voorbeeld uitgaande van de Engelse functie ACCRINT. In Calc NL
> SAMENG.RENTE.
> In de Engelse FunctieWizard wordt als syntax bij deze functie aangegeven:
>         ACCRINT(Issue; First interest; Settlement; Rate; Par; Frequency;
> Basis)
> Op de Engelse helppagina wordt als syntax bij deze functie aangegeven:
>         ACCRINT(Issue; FirstInterest; Settlement; Rate; [Par]; Frequency
> [; Basis])
> In de Nederlandse Functie-assistent wordt als syntax bij deze functie
> aangegeven:
>         SAMENG.RENTE(Uitgifte; Eerste rentetermijn; Vervaldatum; Termijn;
> Nominale waarde (optioneel); Frequentie; Soort jaar (optioneel)
> Op de Nederlandse helppagina wordt als syntaxis bij deze functie
> aangegeven:
>         SAMENG.RENTE(Uitgifte; Eerste rentetermijn; Aankoopdatum; Termijn;
> [Nominale waarde]; Frequentie [; Basis])

As ik dit zo lees dan is dit gewoon door ons vertaalde content. Als we dit
goed in kaart brengen, dan kunnen we dit (denk ik) zelf aanpassen.


> De verschillen in de Engelse syntax is dat op de helppagina's de optionele
> argumenten tussen vierkante haken ([]) worden aangegeven en in de
> FunctieWizard vindt dat plaats in het volgende scherm door de vereiste
> argumenten vet afgedrukt weer te geven, bovendien staat dit ook in de tekst
> erboven weergegeven. Dat lijkt redelijk consistent.
> In de Nederlandse Functie-assistent worden de optionele argumenten, in
> afwijking van de Engelse syntax, aangegeven door de tekst (optioneel)
> achter het argument. Ik kan niet beoordelen of die toevoeging goed of fout
> is. Het levert in ieder geval geen foutcode op.
> Op de Nederlandse helppagina worden de optionele argumenten, evenals op de
> Engelse helppagina, omgeven door vierkante haken. Ook hier kan ik niet
> beoordelen welke wijze van aangeven van optionele argumenten goed of fout
> is.
> Daarnaast zijn er verschillen in de benamingen van de argumenten:
> Vervaldatum > Aankoopdatum en Soort jaar > Basis waarbij eveneens niet is
> aan te geven wat goed of fout is.
>
> M.i. moet de tekst in de UI (Functie-assistent) gelijk zijn aan de tekst
> op de helppagina's. Ik stel alleen vast dat dit niet zo is en kan niet
> bepalen of e.e.a. een bug is.

Ook hier moeten we onderzoeken of de Engelse tekst al fout is, of dat we
dit met  de vertaling recht kunnen trekken. Het is alleen best lastig om
dit in Weblate terug te vinden. Vooral in de Help, die voor zover ik weet
geen q-id heeft.

Groetjes,
Kees

> Hopelijk weet jij hier een oplossing voor.
>
> Met vriendelijke groet,
> Henk van der Burg
>
> -----Oorspronkelijk bericht-----
> Van: Cor Nouws <oolst@nouenoff.nl>
> Verzonden: donderdag 23 mei 2024 14:28
> Aan: Henk van der Burg <h.vdburg@hccnet.nl>;
> documentatie@nl.libreoffice.org
> Onderwerp: Re: Helppagina in de offline help en de verwijzing in menu Help
> naar de documentatiepagina
>
> Hallo Henk,
>
> Henk van der Burg wrote on 23/05/2024 13:32:
> > Hallo Cor,
> >
> > Hierbij nogmaals maar nu via de documentatiepagina. Volledigheidshalve
> > de tekst nogmaals weergegeven.
> >
> > Wij maken tijdens het vertalen van de Engelstalige handleidingen soms
> > gebruik van de knop Help die in veel dialoogvensters aanwezig is.
> > Vooral bij Calc wordt vaak verwezen naar helppagina’s met functies,
> > die niet meer bestaan. Zie bijvoorbeeld de verwijzing naar de functie
> > BOVENGRENS.EXCEL, waar in de tekst wordt verwezen naar de niet meer
> > bestaande Excel-functie BOVENGRENS.
> >
> > Zo komen er meer onvolkomenheden voor in de helppagina’s. Graag willen
> > wij daar verandering in aan laten brengen, maar wij weten niet wie
> > deze helppagina’s onderhoudt en bij wie wij eventuele
> > verbeteringen/veranderingen kunnen aangeven.
>
> De Help is inderdaad een belangrijk onderdeel.
> De bugs (en wensen) daarvoor worden ook bijgehouden in Bugzilla, en
> daarbinnen component Documentation.
> Deze link toont de nieuwe daarbinnen van de laatste 30 dagen:
>
>
> https://bugs.documentfoundation.org/buglist.cgi?chfield=%5BBug%20creation%5D&chfieldfrom=-30d&chfieldto=Now&component=Documentation&email2=cno%40nouenoff.nl&emailtype2=substring&known_name=new_last2days&list_id=1734075&product=LibreOffice&query_based_on=new_last2days&query_format=advanced
>
> > Weet jij wie daarover benaderd kan worden?
>
> Ieder kan de bugs maken.
> Er is natuurlijk ook het documentation project
>    https://wiki.documentfoundation.org/Documentation
> en ook
>    https://community.documentfoundation.org/c/documentation/12
>
> > Daarnaast verwijst het item Handleidingen in menu Help naar een
> > documentatiepagina, die niet door het vertaalteam wordt ondersteund.
>
> Heb je een link naar die pagina?
>
> > Hierin wordt o.a. nog Handleiding voor Beginners (versie 5.0)
> > vernoemd, die al geruime tijd door het vertaalteam is hernoemd tot
> > Basishandleiding voor LibreOffice, waar door ons al een versie
> > gebaseerd op LO 7.6 is uitgegeven.
> >
> > Graag willen wij dit ook verbeteren door de verantwoordelijke
> > persoon/instantie te benaderen over deze achter lopende documentatie.
>
> Het is inderdaad nuttig dit soort gebreken duidelijk te maken. Dan kunnen
> mensen het makkelijker zien om er aan mee te helpen.
>
> Dank voor je vragen!
>
> vr. groet,
> Cor
>
>
> --
> Cor Nouws
> GPD key ID: 0xB13480A6 - 591A 30A7 36A0 CE3C 3D28  A038 E49D 7365 B134 80A6
> - vrijwilliger https://nl.libreoffice.org
> - volunteer https://www.libreoffice.org
> - Member The Document Foundation
> - bizdev @CollaboraOffice
> - ceo www.nouenoff.nl
> - initiator www.mijncloudoffice.nl
>
>
>
> --
> To unsubscribe e-mail to: documentatie+unsubscribe@nl.libreoffice.org
> Problems?
> https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
> Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
> List archive: https://listarchives.libreoffice.org/nl/documentatie/
> Privacy Policy: https://www.documentfoundation.org/privacy

-- 
To unsubscribe e-mail to: documentatie+unsubscribe@nl.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/nl/documentatie/
Privacy Policy: https://www.documentfoundation.org/privacy