gnewsense-dev
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Gnewsense-dev] Improving gNS "Help and Support"


From: Zach Oglesby
Subject: Re: [Gnewsense-dev] Improving gNS "Help and Support"
Date: Sat, 15 Aug 2009 20:28:04 +0200
User-agent: Internet Messaging Program (IMP) H3 (4.3.4)

Quoting Luis Felipe Lopez Acevedo <address@hidden>:

El sáb, 15-08-2009 a las 10:57 +0930, Karl Goetz escribió:

Sounds brilliant, but try and take into account the work already done
in the wiki :)
There is semi-structured documentation already available there, which
could be a handy place to start on your project.


Of course, that can not be wasted.

So far the kiss of death for doco projects has been someone being
nominated as 'in charge', so lets avoid that here and you magically
make stuff happen :)
kk


I'm not a magician but I'll try to help as much as I can :)

Zach, Russell, I started the project[1] that will be our route to create
the documentation.

If you think the list of documents is ok as is, we can prepare to start
with the first document: About gNewSense.

Currently, the Documentation Team has no guidelines or a defined
workflow we can use, so I propose we do the following:

0. Take GNOME Documentation Style Guide as a reference for style
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

What do you think?

That sounds good to me but I don't think all of them need to be docbook'efied. Some of this stuff seems like it would be fine in the wiki. I think thr only stuff that needs to be converted to docbook is the stuff thats going to be put into the OS, like About gNewSense. On that note I would recommend using yelp to display whatever we put in the OS.

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

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

Attachment: binaNe6t1RYoC.bin
Description: PGP Public Key

Attachment: pgp4c6dMyHfHf.pgp
Description: PGP Digital Signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]