Re: [DOC-NL] Consistentie

On Wed, Aug 14, 2002 at 07:10:25PM +0200, S.P. Telgenhof Oude Koehorst wrote:
> Naar mijn mening zou gelijk aan de zgn. coding standard een translation
> standard opgezet kunnen worden. Hierin zouden bijvoorbeeld regels opgenomen
> kunnen worden hoe bepaalde woorden vertaald moeten worden of dat deze juist
> niet vertaald worden omdat ze in de context begrijpelijk zijn. Het gebruik
> van vooraf gedefinieerde entities, zoals in language-defs.ent, zou wellicht
> een optie kunnen zijn.

Het lijkt me een goed idee om zo'n translation standard op te zetten.
Of entities dan een handige oplossing zijn weet ik niet, kan ik niet
goed overzien.
De translation standard moet wel in onze 'eigen' tree komen, dus
bijvoorbeeld in phpdoc/nl/TRANSLATION_STANDARD.

Er zijn een paar dingen die nu in me opkomen:
-zoals je al zei de vertaling van array en flushen: IMO moet je dat
 niet vertalen maar gewoon laten staan
-de vertaling van 'character': her en der is character als 'karakter'
 en elders als 'teken'. Persoonlijk vind ik het laatste beter.
-het gebruik van See also/Zie ook: See also/Zie ook is zowel in de
 Engelse als in de Nederlandse versie inconsequent met betrekking tot
 de dubbele punt die soms wel en soms niet wordt gebruikt. 
 'Zie ook foo and bar' versus 'Zie ook: foo en bar'
 Een echte voorkeur heb ik niet, al gebruik ik om een of andere reden in
 mijn vertalingen wel een dubbele punt.
-het vertalen van 'resource': heb ik (gemakshalve) nooit vertaald
-het vertalen van 'file pointer': idem :)
-Description is vertaald als 'Omschrijving' in de eerste vertalingen,
 maar persoonlijk zou ik 'Beschrijving' beter vinden. Om consequent te
 blijven heb ik dit overgenomen.
-de 'Nederlandse' vervoeging van Engelse werkwoorden: backuppen enzo :)
 Wat is daar de voltooide tijd van? gebackupt? gebackupped? back geuped?
 back geupt? Naja, dat soort dingen...

Toch zullen sommige dingen onduidelijk blijven (dingen als flushen
e.d.). Moeten we die dan uitleggen of niet? Persoonlijk twijfel ik daar
een beetje over - aan de ene kant moet je zo dicht mogelijk bij de
engelse versie blijven maar het moet natuurlijk ook begrijpbaar zijn
voor de Nederlanders (het moet niet zo worden dat ze de Engelse versie
of een Engels woordenboek erbij moeten halen om te begrijpen wat er
nou staat).

Commentaar en toevoegingen zijn welkom. 

Sander