Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 24 Feb 2009 02:28:06 +0200
From:      Giorgos Keramidas <keramida@ceid.upatras.gr>
To:        freebsd-questions@freebsd.org
Subject:   Re: hi
Message-ID:  <877i3gk7ah.fsf@kobe.laptop>
In-Reply-To: <20090223160951.056f54d1@scorpio> (Jerry's message of "Mon, 23 Feb 2009 16:09:51 -0500")
References:  <9ef7e7380902220154t74657d52uc9497c77672b79f8@mail.gmail.com> <9a52b1190902220711u65e38320t97ca56547bef246d@mail.gmail.com> <87ljryccm0.fsf@kobe.laptop> <49a20440.oqh9j8d04xp6dYo8%perryh@pluto.rain.com> <87mycd847c.fsf@kobe.laptop> <20090223195041.GC58188@kokopelli.hydra> <20090223160951.056f54d1@scorpio>

next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, 23 Feb 2009 16:09:51 -0500, Jerry <gesbbb@yahoo.com> wrote:
> Specifically, what is it we are uncomfortable putting in the handbook?
> More importantly, what good is a handbook if it is not complete?

That's one way of looking at it.  The obsessive compulsive perfectionist
perspective is that a Handbook is *never* complete, because by the time
you have finished writing about something in a professional, clean and
amusing to read manner, it has been superseded by recent advances :-)

> Would the documentation be cross indexed so a user could find more
> details on a particular subject?  Personally, while perfectly
> plausible, it sounds like more work than it is worth.

The cross-indexing bits are what made me think about our Wiki while
pondering how to write this sort of stuff.  I will experiment by writing
in plain text first, wikifying bits and pieces later, and see where this
leads me.




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?877i3gk7ah.fsf>