On Sat, 23 Nov 2002, Eric Windisch wrote:
> It would be an invaluable tool to be able to be able to append notes to
> the official documentation and to contributed documentation.
> I've seen some contributed documents which contain inaccurate information
> or not enough information.. likewise, the official documentation could
> greatly benefit from user-contributed notes.
> For example, the "Integrating Apache::Session and Mason" How-To could
> mention that Apache::Session::Storage::Postgres is broken with
> modperl/mason and requires a patch (which is a known bug since at least
> 2001)... this is something, that if appended as a note, could make the
> usefulness of the document much greater.
Yeah, that doc is rather outdated. I may create a replacement which says
"use MasonX::Request::WithApacheSession" ;)
> Appending such notes are used by the PHP and Postgresql manuals and
> provides additional insight that the original author may not have had or
> hadn't enough time to explain in detail.
The only problem is what do you do with attached notes when there's a
major change in the system? For example, notes for 1.15 will probably
apply pretty well to 1.16, but definitely not to 2.0.
we await the New Sun