At 11:41 AM +0200 2005-09-30, Brad Knowles wrote:
The official documentation is maintained by Dr. Mills at
<http://www.eecis.udel.edu/~mills/ntp/html/index.html>. Dr. Mills
invented NTP, something like twenty years ago. And yes, his
documentation tends to be exhaustive and generally aimed at other
people like himself.
I should add that I don't really consider this to be a flaw, more
of a quirk. For one thing, I usually appreciate it when people give
me all the available information, and let me make the decision as to
what is important. For another, I tend to write the same way myself,
so I can't really blame anyone else for what would otherwise be a
flaw that I share with them.
In this case, you're getting the Haynes or Chilton's Guide along
with the car. Hell, you're getting the whole damn encyclopedia.
Of course, you didn't want the Haynes or Chilton's Guide, and you
especially didn't want the Encyclopedia. You want a single page that
tells you everything you need to know.
The problem is guessing just precisely what it is that you need
to know, and therefore which single page to pull out of the
Guide/encyclopedia. Unfortunately, some people want to change the
oil, other people want to change the windscreen washer fluid, some
want to check the coolant levels, and others want to know how to
safely do a jump-start.
I don't think you can get all that on a single page, at least not
without causing the same kind of confusion as you were trying to
eliminate in the first place by producing just that one page.
Anyway, right now the best we've got are the FAQ and the
community supported documentation, along with the "QuickStart" guides
that we link to.
If you can help us improve and simplify this documentation, that
would be greatly appreciated. In the case of the community supported
documentation, you could make those changes yourself (if you were so
inclined), but you're also welcome to make on this mailing
list/newsgroup whatever recommendations you may have.
--
Brad Knowles, <[EMAIL PROTECTED]>
"Those who would give up essential Liberty, to purchase a little
temporary Safety, deserve neither Liberty nor Safety."
-- Benjamin Franklin (1706-1790), reply of the Pennsylvania
Assembly to the Governor, November 11, 1755
SAGE member since 1995. See <http://www.sage.org/> for more info.
_______________________________________________
questions mailing list
[email protected]
https://lists.ntp.isc.org/mailman/listinfo/questions
