Re: Nederlanstalige FAQ

Ewoud Kohl van Wijngaarden wrote:

> On Tue, 21 Sep 2004 18:16:52 +0200, Cedric Vonck <[email protected]>  
> wrote:
>
>> Groepsleden,
>>
>> Zoals gisteren reeds geopperd door iemand (Dennis Speekenbrink) zou 
>> ik  een aanzet willen geven tot een
>> FAQ voor het nederlandstalige documentatie team.
>>
>> Wat zou er in moeten komen?
>> Zien jullie dat als een "draaiboek"?
>> Moet er een mapping van (sommige) Engelse woorden naar het 
>> Nederlands  erbij?
>
> dit zeker, de meest gebruikte woorden moeten we gelijk trekken,  
> bijvoorbeeld had ik laatst nog filesystems, ik wist niet of ik dit wel 
> of  niet moest vertalen, maar laat ik het enigsinds chronolisch 
> neerzetten

Een woordenlijst is zeker handig (c.q. noodzakelijk) want dat maakt het 
lezen (en begrijpen) van het handboek een stuk eenvoudiger.  Het 
voorkomt dat een gebruiker zich moet afvragen of 2 termen daadwerkelijk 
bedoeld zijn als 2 aparte dingen of niet.  Daarentegen kan een 
woordenlijst behoorlijk uitgroeien.  (meer hierover verderop)

Onderstaand stappenplan is een goede aanzet:

> om te beginnen dat je je aanmeld bij de nieuwsbrief
> dan hoe je meld wat jij wil doen
> dan komt hoe de vertaling zelf vooral moet, dus:
>     hoe moeten we precies die header zetten (ik weet het ook niet echt)
>     dat we bijvoorbeeld het beste de Engelse tekst als commentaar 
> erbij  kunnen houden (lijkt mij, discussie hierover graag)

Dat is een goede tip!   Dit maakt controles van vertalingen (dus niet de 
tikfouten, maar de echte vertaling) makkelijker.  Eventueel is maakt dit 
het ook makkelijker zoeken naar veranderingen in het engelse document.  
Wat me eraan doet denken:  Hoe zoek ik uit wat de verschillen zijn 
tussen 2 versies van een engels document?  Kan ik de patch, of het 
bugreport ergens vinden?

> hoe je het doet als je iets vertaald hebt en klaar bent, wat dan?
> en dan tot slotte die tabel met woorden die we wel en niet vertalen en 
> hoe  etc
>
> verder zou ik graag een credits pagina zien, welke documenten door 
> wie  vertaald zijn
> dit is dus ook een overzichtspagina waar versie nummers zo mogelijk 
> bij  kunnen

Dit is een mooi iets, maar niet strikt noodzakelijk, en kan behoorlijk 
ego-versterkend, maar ook conflicterend werken. 
Wordt iemand ook genoemd voor het opmerken van een tikfout?  of alleen 
een nieuwe-versie vertaling, of alleen een eerste versie (hoofddocument) 
vertaling?
Het bijhouden kan ook behoorlijk uit de hand lopen, als de bijdragen, en 
de hoeveelheid documentatie toenemen.  Wellicht dat hier een systeem van 
gemaakt kan worden zoals ik eerder heb gezien:
alle bijdragen van de laatste 2 maanden (ofzo) worden getoond bij de 
credits.  Dit zorgt dat iemand er niet te lang op staat, en dat hij/zij 
toch een waardering krijgt ook al is het maar het opmerken van een tikfout.
Dit vergt nog steeds wat (overbodige?) administratie, dus hier moet 
iemand _zin_ in hebben om het bij te houden.

>
> verder als we klaar zijn met het handboek zijn er nog veel applicatie  
> specifieke handleidingen, maar dat komt later

Had ik ook al gezien, en ik zie het vertalen van dergelijke documenten 
op termijn wel zitten.  Ze veranderen niet zo snel, maar voegen wel een 
hoop waarde toe.  Ik denk dat dit makkelijk toe te voegen is aan de todo 
lijst, mits aangegeven dat er een lagere prioriteit voor geldt.

>
> misschien kan er ook nog een todo list komen zodat iedereen altijd 
> kan  checken wat wel en niet klaar is
>
> dit is even snel uit het hoofd hoor, ik heb misschien voor anderen te 
> veel  er in, anderen te weinig, dit is wat mij erg handig lijkt
>
Het lijkt me handig de FAQ eens per maand op de lijst te posten (met 
todo/progress list?).  Dit zorgt voor een kleine herinnering aan alle 
geabbonneerden, en een houvast.  Deze kan dan ook door alle leden 
aangehaald worden wanneer een nieuw lid vragen stelt.
Voor de woordenlijst (wanneer 'ie groot wordt) en de creditspagina:  
naast de maandelijkse FAQ posting, zal er voor de twee grotere 
onderdelen waarschijnlijk een website moeten komen.
Als het niet lukt om die via Gentoo te hosten, wil ik wel zorgen voor 
hosting en de technische opbouw van de site.

Zie ik de de FAQ als een draaiboek?  Niet echt, maar wel als een globale 
handleiding.  Als ik de FAQ gelezen heb, moet ik de rest met zelfstudie 
kunnen redden.  Het hoeft dus geen stappenplan te zijn, maar wel de 
benodigde informatie aanreiken.

Ik heb hieronder nog een paar FAQ vragen bedacht.

Mvgr,
Dennis




Voorbeeld vragen voor de FAQ:

Moet ik een heel document vertalen?
A:  nee, er kunnen ook documenten vertaald zijn waarvan de 
oorspronkelijke engelse versie verouderd is.  Deze moeten worden 
bijgewerkt tot ze een goede vertaling van de huidige engelse versie zijn.
Dit is een goede manier om aan het vertalen te wennen, zonder dat er 
gelijk een heel document aan zit.

Hoe kan ik beginnen met vertalen?
A:  Zie de volgende links voor respectievelijk de documentatie policy 
van Gentoo, de XML-structuur van de Gentoo documentatie, en een handige 
opzet voor vertalen onder Gentoo:
http://www.gentoo.org/proj/en/gdp/doc/doc-policy.xml
http://www.gentoo.org/doc/en/xml-guide.xml
http://www.gentoo.org/proj/en/gdp/doc/doc-tipsntricks.xml
(geleend uit een maillinglist post van Sven Vermeulen)
Lees ook de woordenlijst op <hier url van onze woordenlijst> door zodat 
we een gelijke vertaalstijl hanteren.

Krijg ik officiele erkenning voor vertalingen?
A:  In principe niet.  Alleen de lead-translator en de follow-up 
translator worden door Gentoo erkend (toch?????).  Echter uw mede 
vertalers weten de NL-Gentoo pagina met uw bijdrage wel te vinden:
<hier url van de credits pagina>

Deze term kent geen (goede) nederlandse vertaling, hoe moet ik daar mee 
omgaan?
A:  Kijk op de NL-Gentoo pagina <hier weer zo'n url> voor een 
woordenlijst met veel voorkomende begrippen.  Indien deze er niet op 
staat, kunt u het woord in het engels met nadruk (<e> </e> tags) weer 
geven.  Bij twijfel vragen op de maillinglist of aan de (follow-up) lead 
translator.

Wat doe ik met een vertaald document?
A:  Laat het lezen door anderen!  Post het op de maillinglist, met de 
vraag of anderen het willen controleren.  Zij geven u dan weer 
opmerkingen, of fouten door.  Wanneer u die verwerkt heeft, kunt u het 
indienen bij de (follow-up) lead-translator.

Ik wil een vertaling bijwerken waarvan de engelse versie onlangs is 
gewijzigd.  Hoe doe ik dat?
A:  Laat op de maillinglist bekend welk document u wilt bijwerken, en 
naar welke engelse versie u het bijwerkt.  Dit voorkomt dubbele 
vertalingen.  Wanneer u hiermee klaar bent, kunt u de patch (zie eerdere 
links) indienen bij de (follow-up) lead-translator.  Wanneer de 
wijzigingen groot zijn, kunt u uw vertaling ook eerst integraal laten 
controleren door leden van de maillinglist door het eerst daar te posten.

Ik ben het engels niet meester maar <andere taal> wel.  Kan ik 
documenten van die taal naar het nederlands vertalen?
A:  Dit is geen aan te raden manier, maar als er van een document nog 
geen vertaling bestaat, dan is het mogelijk toch interessant.  Laat dan 
uw vertaling controleren door de maillinglist met het uitdrukkelijke 
verzoek om de vertaling te controleren met het oorspronkelijke engelse 
document.  Binnen de Gentoo documentatie zijn de engelse documenten 
altijd de officiele.


--
[email protected] mailing list