[ntp:questions] Re: Latest changes to TWiki GettingStarted

Harlan Stenn stenn at maccarony.ntp.org
Sun Oct 5 01:27:07 UTC 2003

We agree on the goals...

My belief is that the existing GettingStarted page will need to grow and
evolve beyond the point where it can be useful (or maintained) as a single
document, but that's just my opinion and I'm happy to be shown otherwise.

And I also agree that the pages under "General Options" need to be easier
to navigate.  Maybe Steve has some ideas on how that can be improved.

I also expect that somebody else may have a different idea of how to help
folks get started, and we should have an easy way to allow this.

Anyway, I'm inclined to see the existing GettingStarted page moved to a
new name (maybe QuickStart?), and then have the new GettingStarted page
contain a pointer to that page and also the existing stuff under the
"General Options".

That way we can use a single pointer to the GettingStarted page and
people will have an easy choice of which style of info they would like
to use.


In article <87lls036yl.fsf at netnews.comcast.net>,
Dale Worley  <worley at dragon.ariadne.com> wrote:

>IMHO, the monolithic structure is necessary -- The point is to get the
>user from zero to "ntp synced" as easily as possible.  An information
>source that needs to be navigated works against usability.  The best
>is a single document that can be read and acted upon in linear order.
>Of course, that does increase the effort needed to maintain it, since
>you can't just edit a sentence here or there without considering its
>impact on the rest of the document.  But it seems to me that getting
>one's ntpd configuration started is the single largest barrier to NTP

More information about the questions mailing list