On Fri, 8 Feb 2002, Tom Lane wrote:
> Vince Vielhaber <vev@michvhf.com> writes:
> >> Vince, the docs were finalized when the release came out. Whatever was in
> >> the release tarball is the final documentation.
>
> > That's what I incorrectly assumed when 7.1 came out. What was released
> > still needed some cleanup. So until I know for a fact that the docs are
> > in good enough shape to be put on the website, they're not put there.
>
> That seems overly strict. Why not put up what you have ASAP? If they
> need to be updated later, then replace 'em ... but better to have
> not-quite-final docs than no docs.
Well lessee. Until Peter's comment earlier, there has been no mention
about the docs being final or even close. There was no doc freeze. The
last comments I recall seeing about them at all was in early December.
And from that I'm to assume that they're in good enough shape? One thing
I learned in the last five years here, never assume anything. But at this
point it's irrelevant since I don't intent for it to be my problem when
7.3 is released.
> Or at least put up a link to the development docs saying not-quite-final
> docs can be found _over_here_. The problem isn't that there are no docs
> available, it's that there's no link in the place that non-developers
> would expect to look.
Now that would be an unrecoverable mistake. Any implications at all that
point to the development docs as being release quality will lead people to
expect the development docs to always be at release quality which is
simply untrue. It will invite linking to them and the problems that are
associated with that. Remember? That's one of the reasons I seperated
the two sites.
Vince.
--
==========================================================================
Vince Vielhaber -- KA8CSH email: vev@michvhf.com http://www.pop4.net 56K Nationwide Dialup from $16.00/mo
atPop4 Networking Online Campground Directory http://www.camping-usa.com Online Giftshop Superstore
http://www.cloudninegifts.com
==========================================================================