Re: Installation Guide TODO list

["Stuart Ellis" <s ellis fastmail co uk>]

On Tue, 25 Jan 2005 03:14:28 -0800 (PST), "Rahul Sundaram"
<rahulsundaram yahoo co in> said:
> Hi
> 
> > 
> > 
> > We could ask the fedora-devel for a standard method
> > if
> > it exists.
> 
> this is part of a larger problem. we need the
> development list to cc the docs list for major changes
> and document them when necessary. following the gnome
> development model for this would be possible. it
> requires more coordination than the current state.
> fedora docs at present seems to be very isolated from
> the developers who need to concerned about the lack of
> documentation

I think that this a circular problem.  Fedora and GNOME developers have
seen the benefits of usability, so they push for better usability
themselves.   I don't think that documentation is seen as a critical
part of developing useful software.  Community documentation work is too
fragmented to have a strong voice in development, and cannot point to
any spectacular success in the same way that usability work has
revolutionised GNOME.

Short version - if we want developers to invest their time on
documentation issues then documenters have to produce work that is high
quality and visibly successful.
--

Stuart Ellis
s ellis fastmail co uk