lkml.org 
[lkml]   [2005]   [Nov]   [22]   [last100]   RSS Feed
Views: [more markup]  [less markup]  [headers]  [forward] 
 
Messages in this thread
/
DateTue, 22 Nov 2005 01:18:45 -0800
FromPaul Jackson <>
SubjectRe: [RFC] Documentation dir is a mess
> The documents
> that exist may not conform themselves well to that sort of division,
> necessarily.

Good point, not just for -that- sort of division, but perhaps for
any sort.

I am skeptical that there is much value to be added to the current
hodge podge of documents in the Documentation directory by rearranging
them in some grand scheme.

Certainly there is some value that can be subtracted -- just changing
it will result in some minor cost to each of us, adjusting to the
changes.  The greater the changes, the more aggressive the effort to
categorize it, the greater this distributed cost of change.

Perhaps what we have is deeper than just improperly arranged Docs.
The content of the Docs may have too much variation in depth, topic,
breadth, organization, style and such to be well suited to a deep
structure.

Maybe it looks disorganized because it is -- more than just skin deep.

-- 
                  I won't rest till it's the best ...
                  Programmer, Linux Scalability
                  Paul Jackson <pj@sgi.com> 1.925.600.0401
-
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/

\
 
 \ /
  Last update: 2005-11-22 10:22    [from the cache]
©2003-2008