Re: Proposed: gnome-system-tools

[Shaun McCance <shaunm gnome org>]

On Mon, 2004-07-19 at 20:05 +1000, Jeff Waugh wrote:
> (This is a thread-starter for the final module discussion before the release
> team reports back with a summary and proposal, which will aim to represent
> the consensus of the community. Please be kind to authors, and start totally
> new threads if there's a reason to shift off-topic.)
> 
> Description:
> 
>   System configuration tools for common desktop user tasks.
> 
> Proposal:
> 
>   http://mail.gnome.org/archives/desktop-devel-list/2004-June/msg00099.html

(This is my analysis of the documentation, wearing my GDP FL hat.  This
is not my opinion of the program or its appropriateness for inclusion in
the Gnome desktop.)

There seems to have been some effort to produce g-s-t documentation
since the initial proposal.  However, a lot more work needs to be done
to get really good docs.  Most of these tools deal with things most
users don't fully understand, and some explanation of what they're
actually dealing with is essential.

Documenting system tools well is a tough task.  As long as we leave it
up to vendors to produce system tools, we can leave it up to vendors to
document system tools.  If we're to start providing system tools with
Gnome, we need to make a very serious effort to document them well.

--
Shaun