Quoting Karl Goetz <[email protected]>:

0. Take GNOME Documentation Style Guide as a reference for style

Try not to get to bogged down being correctly styled. Hack on doco.
Make words. When you've got a bit of a groove happening start to make
your lives harder.

1. Open the project for the document About gNewSense
2. Propose a structure for the document (in any format)
3. Define the final structure from the proposals
4. Propose the content
5. Write a draft in the wiki combining the content proposals
6. Revise and improve
7. Write the final document in DocBook

7 is the step that worries me most out of those. If your going to be
doing that perhaps a script to automate wiki -> docbook would be in
order (one may exist already). Even if it just automates the basics,
its a lot better then a full rewrite.

The resultant docbook should probably wind up in a revision control
system of some sort as a 'step 8'.


I will look around for a script to convert it to docbook, the ones I have seen do an ok job but we will still have to fine comb it. As for the version control I agree, I was going to suggest that as well. Not sure what gNS uses for version control or who to talk to about getting them set up though.

--
Zach Oglesby
GPG Key: 1378F79F
http://fedoraproject.org/wiki/User:Zoglesby

----------------------------------------------------------------
This message was sent using IMP, the Internet Messaging Program.

Attachment: binu3KMUeiAyy.bin
Description: PGP Public Key

Attachment: pgpJEKG4SXK8Z.pgp
Description: PGP Digital Signature

_______________________________________________
gNewSense-dev mailing list
[email protected]
http://lists.nongnu.org/mailman/listinfo/gnewsense-dev

Reply via email to