Date: Wed, 20 Oct 2004 15:30:58 -0700
From: Andrew Morton <akpm@osdl.org>
To: Jim Nelson <james4765@verizon.net>
Cc: linux-kernel@vger.kernel.org
Subject: Re: [RFC] Structural changes for Documentation directory
Message-Id: <20041020153058.6de41ed8.akpm@osdl.org>
In-Reply-To: <4176CFE3.2030306@verizon.net>
References: <4176CFE3.2030306@verizon.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Sender: linux-kernel-owner@vger.kernel.org
Content-Length: 1296
Lines: 28

Jim Nelson <james4765@verizon.net> wrote:
>
> I propose changing the structure of the Documentation directory to 
> reflect the structure of the kernel sources itself.

That sounds like a bit of overdesign, really.  Take it one step at a time.

Sure, if you're really prepared to do a large-scale overhaul then the first
step is to create a new top-level directory, say
"./non-crappy-Documentation" and then move files over into there as they
are fixed up.  That way we have a good handle on what is done and what
remains.  You can then make decisions about the directory structure
on an incremental basis as you become more familiar with the problem.

> Perhaps it would be best to put the new tree in place and have the 
> individual maintainers relocate their documentation to the new 
> structure?

Maintainers studiously ignore the Documentation directory.  If someone
really wishes to get in there and fix it all up, that person gets to decide
what goes where and that person gets to harrass various other maintainers
when assistance is needed.

-
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/