Re: [RFC] Documentation dir is a mess

From: Paul Jackson (pj_at_sgi.com)
Date: 11/22/05

  • Next message: Matthias Andree: "Re: what is our answer to ZFS?" 
    Date:	Tue, 22 Nov 2005 01:18:45 -0800
To: Matthew Frost <artusemrys@sbcglobal.net>

    > 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/
  • Next message: Matthias Andree: "Re: what is our answer to ZFS?"

    Relevant Pages

    • Re: why do a male use a female char?
      ... felt like it was a joke (how can beauty be skin deep ... more if I had hawter looking characters though. ... I've very occasionally had a bit of this sort of thing ... When I left Undercity the 14-year-old checked /who to see ...
      (alt.games.warcraft)
    • Re: [RFC] Documentation dir is a mess
      ... "fingertip reference" versus "in-depth documentation". ... that exist may not conform themselves well to that sort of division, ... send the line "unsubscribe linux-kernel" in ...
      (Linux-Kernel)
    • Re: [BUG] r200 dri driver deadlocks
      ... Where in the DRM I can proform the needed test and sort. ... Do you Yahoo!? ... send the line "unsubscribe linux-kernel" in ...
      (Linux-Kernel)
    • Happy New Year, libata hackers
      ... After a nice and refreshing holiday, I have a bunch of patches pending, that will probably take a week or two to sort through. ... my main goals are getting irq-pio upstream and supporting iomap -- which will kill all those annoying warnings finally. ... The suspend/resume stuff is shaping up nicely, and device hotplug work suddenly reappeared. ... To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/ ...
      (Linux-Kernel)
    • Re: [PATCH/RFC] A method for clearing out page cache
      ... > of the time for the wrong reasons), and the last thing we want to enable ... sort of "average" workload. ... send the line "unsubscribe linux-kernel" in ...
      (Linux-Kernel)