Howto's-met-LinuxDoc-mini-HOWTO: Schrijven van de HOWTO

Next Previous Contents

## 11. Schrijven van de HOWTO

## 11.1 Voor je begint te schrijven

Stuur eerst een email naar de HOWTO coördinator Greg Ferguson mailto:linux-howto@metalab.unc.edu of mailto:feedback@linuxdoc.org. Wanneer je een onbeheerde HOWTO overneemt, neem je eerst contact op met de auteur. Dit kan vereist zijn door de copyright-licentie, maar je zou het uit beleefdheid moeten doen ook al is het niet vereist.

## 11.2 Richtlijnen

Deze zijn voornamelijk afkomstig van Tim Bynum (voorheen HOWTO coördinator).

- Zorg ervoor dat je een geaccepteerd formaat gebruikt (zoals LinuxDoc :-).
- Probeer een betekenisvolle structuur en organisatie te gebruiken, en schrijf duidelijk. Denk eraan dat veel van de mensen die HOWTO's lezen als moedertaal geen Engels spreken.
- Zorg dat alle informatie correct is. Ik kan dit niet genoeg benadrukken. Bij twijfel, speculeren, maar maak duidelijk dat je slechts gist. Ik gebruik ?? als ik er niet zeker van ben.
- Zorg dat je de meest recente versie van de beschikbare software behandeld.
- Overweeg een "FAQ" sectie op te nemen. Het kan ook de naam "Algemene Problemen" of "Probleemoplossing" krijgen.
- Zorg dat het copyright op je naam staat en voeg een licentie toe die tegemoet komt aan de vereisten uiteengezet in de LDP manifesto.
- Gebruik de standaardheader met de titel, auteur en datum. (inclusief een versienummer). Zie Voorbeeld 3
- Wees er als laatste op voorbereid dat je via email vragen en opmerkingen van lezers zult ontvangen. Hoeveel je mensen helpt is aan jou, maar je zou gebruik moeten maken van goede suggesties en verslagen met fouten. Het kan ook zijn dat je via email "dank je" te horen krijgt als ook email zal ontvangen van mensen die je om hulp vragen die zelfs je HOWTO nog nooit hebben ingekeken.

## 11.3 Aanleveren van de HOWTO, enz.

Nadat je de HOWTO hebt geschreven, email je de SGML-broncode naar submit@linuxdoc.org. Dan hoef je de HOWTO alleen nog bijgewerkt te houden door periodiek updates aan te leveren via hetzelfde emailadres dat je gebruikte voor de eerste editie.

Next Previous Contents