Documentating the configuration files

[Dave Pawson]

At 09:05 27/12/2003, Karsten Wade wrote:
>On Fri, 2003-12-26 at 15:18, Jan Fabry wrote:
> > Hello,
> >
> > Are there any plans to documentate the configuration files,



>This is an interesting idea.  It is reminiscent of the RHEL Reference
>Guide
>(http://www.redhat.com/docs/manuals/enterprise/RHEL-3-Manual/ref-guide/), 
>which has many chapters devoted to config files.  Of course, something of 
>that size and type _is_ out of scope for the Fedora docs project.
>
>However, a very tight config file reference that was e.g. organized sets
>of files done as multiple <variablelist> entries would be very useful,
>even if such a reference work is outside of the FDP scope.
>
>The real question is, how do you decide what exactly to document?


<snip/>

I like the idea.
A simpler start might be:

1. List the files, a two line description of what they are for,
    possibly any cross links (see also xxx) (impacts on yyy)
2. From that, it would be possible to develop into a further detailed
    document. The comment about it needing lots of updates would be
    a good 'stop here' notice.
*if* the man pages are adequate, then a reference to them might
be the final entry? If not it at least points out the need for a man page?

HTH daveP