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

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/.  
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])

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.

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