Re: [gnome-db]Users guide

[Rodrigo Moya <rodrigo gnome-db org>]

On 13 May 2001 17:18:03 +0200, Sean Allen wrote:
> Hi, I see you need someone to write a users guide.
> I would be interested in doing this.
> 
> obviuosly, if someone else has already volunteered for this, let me
> know.
> 
no, nobody is working on this, so please do it, we'll be very grateful
if you do a nice user's guide.

> A point of clarification, do you want the UG to cover just the
> gnomedb-fe (i.e. the GUI) part of gnome-db, or to include a more general
> overview of the whole package.
>
I would cover all the user tools, that is both the gnomedb-fe, as well
as the GDA command-line tools (although right now almost non-existant).
So, to begin with, I suggest you to try to cover the front-end only.
Then, as soon as we add/fix the GDA command-line tools, more chapters
about those tools could be added to the user's guide.
 
> I have not, as yet done any documentation for the gnome project, but
> have written documentation for other (non-free) software.
> I want to practice my docbook skills and this seems like an excellent
> way to do so
> 
you can have a look at how the DocBook we use looks like in the file
gnome-db/doc/C/gnome-db.sgml. And you've got a very nice book about
DocBook at www.docbook.org

> let me know if you still need the help and tell me if you have and
> special needs/vision for the users guide
> 
please, write the user's guide :-) Only one thing, use the CVS version, since
I've added several UI changes. Also, BTW, if while you use the front-end
to write the user's guide, you've got any suggestion, please tell us.

cheers

-- 
Rodrigo Moya <rodrigo gnome-db org> <rodrigo ximian com>
http://www.gnome-db.org/