Date: Wed, 20 Oct 2004 12:48:21 +0200
From: Adrian Bunk <bunk@stusta.de>
To: Jim Nelson <james4765@verizon.net>
Cc: linux-kernel@vger.kernel.org
Subject: Re: Documentation - what work is being done?
Message-ID: <20041020104821.GA23318@stusta.de>
References: <4172CBA9.5070009@verizon.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <4172CBA9.5070009@verizon.net>
User-Agent: Mutt/1.5.6+20040907i
Sender: linux-kernel-owner@vger.kernel.org
Content-Length: 1694
Lines: 41

On Sun, Oct 17, 2004 at 03:44:41PM -0400, Jim Nelson wrote:

> Is there any effort being made to update the stuff in the Documentation 
> directory?  Most of the files in there are massively out of date.  I'd 
> like to work on it - but I didn't see an entry for documentation in the 
> MAINTAINERS file.  I googled around for mailing lists for kernel 
> documentation, but the two I found have been dead for some time.
> 
> I think the whole directory needs an overhaul, but there's a lot of 
> people's work in there (and I'd hate having my work torn to pieces by a 
> rank amatuer), and I'd like some feedback on where to start, what to 
> leave alone, what's there for historical interest, and what is 
> critically needed.

Hi Jim,

some documentaion is well maintained while other documentation is no 
longer maintained. If it's maintained, the maintainer of the 
corresponding code is also responsible for the documentation.

If you have a plan how to restructure the documentation mail it to 
linux-kernel and you'll hear the opinion of other people.

Everything else has to be done on a file-per-file basis and usually 
requires a knowledge of the topic a documentation file covers.

cu
Adrian

-- 

       "Is there not promise of rain?" Ling Tan asked suddenly out
        of the darkness. There had been need of rain for many days.
       "Only a promise," Lao Er said.
                                       Pearl S. Buck - Dragon Seed

-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/