Meewerken aan de Officieuze Fedora FAQ

Ik heb graag bijdrages aan de FAQ! Als je wilt bijdragen, zijn er twee manieren. De eerste is de gemakkelijkste: stuur me tekst! De tweede is zelf beter: schrijf zelf de HTML en stuur die naar mij! (Zie verderop in deze pagina voor enkele richtlijnen voor HTML.) Je kunt elke bijdrage die je hebt naar mij emailen.

Richtlijnen

Hiereonder staan enkele richtlijnen die ik zelf gebruik voor het schrijven van de FAQ. Maak je er niet druk om als je een bijdrage hebt die hier iets vanaf wijkt -- ik kan je helpen als je mij een email stuurt! In geval van twijfel kun je de FAQ lezen en zien hoe de huidge vragen zijn geschreven.

Doel van de FAQ: Het helpen van alle computer gebruikers die Fedora gebruiken, door hen oplossingen aan te bieden voor de meest voorkomende problemen in Fedora.

Doelgroep: Als ik de FAQ schrijf, denk ik aan een lezer die nooit eerder Linux heeft gebruikt, maar nu Fedora wil uitproberen. Op die manier kunnen nieuwe gebruikers de FAQ begrijpen, en gevorderde gebruikers kunnen het nog steeds gebruiken als een nuttige bron.
De vraag moet vaak gesteld worden. Voor minder vaak gestelde vragen is FedoraForum een goed hulpmiddel. Bijvoorbeeld, "Ik kan Fedora niet installeren op mijn gloednieuwe Dell computer, wat moet ik doen?" wordt zeker vaak gevraagd. "Hoe schrijf ik een C++ programma in Fedora om mijn sokken te roosteren?" wordt zeker niet vaak gevraagd.
Het is gewoonlijk erg eenvoudig om op FedoraForum rond te kijken en te zien of mensen steeds weer dezelfde vraag stellen. :-) Als je twijfelt kun je mij de vraag sturen en ik zal je laten weten of hij vaak gevraagd wordt!
Eenvoud: Ik probeer de FAQ antwoorden zo eenvoudig mogelijk te maken. Dat betekent dat als er meer dan een manier is om de vraag te beantwoorden, ik altijd die zal kiezen die het eenvoudigste zal zijn voor een nieuwe gebruiker. Soms zal het niet het "beste" antwoord zijn, maar het zal altijd werken en gemakkelijk zijn. Bijvoorbeeld, hierom gebruik ik yum in deze FAQ inplaats van apt -- yum zit in Fedora, en apt is een extra download, dus ingewikkelder.
Dit betekent ook dat ik geen woorden gebruik die nieuwe gebruikers niet kennen. Als ik zo'n woord moet gebruiken, zal ik het altijd uitleggen voordat ik het gebruik.
Beknopt: De FAQ moet beknopt zijn. Ik heb het graag als een nieuwe gebruiker de gehele FAQ gemakkelijk in een zitting kan doorlezen. Ik heb de neiging om zinnen die niet nodig zijn te verwijderen.
Fedora-specifiek: Gewoonlijk gaan FAQ vragen over dingen die in het bijzonder Fedora gebruikers raken. Er zijn een groot aantal bronnen op het Internet voor algemen Linux hulp, maar niet zoveel specifiek voor Fedora. Dus, de FAQ probeert een Fedora hulpbron te zijn. Als je een algemene vraag over Linux basis kennis wil bijdragen die toch nuttig zou zijn voor Fedora gebruikers, dan kun je bijdragen aan de Fedora Basis FAQ!
Duidelijk: Voor veel lezers van de Fedora FAQ is engels niet hun moedertaal. Dus ik probeer de FAQ vragen en antwoorden zo duidelijk mogelijk te houden, en ik probeer complexe woorden te vermijden.
Karakter: Het is goed om soms een grapje, te maken. Soms laat ik zinnen staan die er niet hoeven te zijn, omdat ik denk dat ze een beetje karakter aan de FAQ toevoegen, waardoor deze met meer plezier te lezen is.

HTML Richtlijnen

Als direkt aan de HTML wil bijdragen, maak je me echt blij! Hieronder staan enkele richtlijnen die ik gebruik in de HTML van de FAQ. Geef er niet om als je ze niet allemaal in jouw HTLM kan krijgen -- email mij en ik kan helpen. :-)

Eenvoudige XHTML Structuur: Alle vragen hebben dezelfde structuur, als je je eigen HTML wil insturen, bekijk dan de broncode van de FAQ en "vul lege plekken in." Alle HTML in de FAQ pagina valideert als XHTML 1.0 Strict.
Consequente Stijl: Dit wordt bereikt door de XHTML (het punt hierboven) en door mijn CSS. Het geeft niets als je niet veel over CSS weet -- zoek eenvoudig naar een deel van de FAQ die lijkt op wat je wilt en gebruik hiervan de broncode.
Verbreek nooit een link: Er zijn honderden (misschien wel duizenden) links naar deze FAQ op het Internet, geen van hen mag ooit een "404 Not Found" teruggeven behalve als zij een tikfout gemaakt hebben. Ook de ankers (het deel na het "#" teken) moet altijd werken. Dit betekent dat als jij de naam van een anker verandert, laat dan een kopie staan met de oude naam op de oude plaats.
Zie Cool URIs don't change (geschreven door diegene die HTML en het WWW heeft uigevonden) als wilt weten waarom ik dit doe.

Deze FAQ wordt ouderhouden door Max Kanat-Alexander. Dat is max [at] fedorafaq *dot* org of "mkanat" in het #fedora IRC kanaal.

Je kunt helpen om deze FAQ up to date te houden! Als je een onderwerp weet dat we niet behandelen, fouten vindt in de antwoorden die we hier geven of een andere suggestie hebt, neem dan contact met ons op en we zullen er naar kijken.

De Nederlandse vertaling is gemaakt door Geert Warrink, geert.warrink [at] onsnet *dot* nu. Als je opmerkingen hebt over de vertaling laat het me dan weten!