In perl.documentation, you wrote:
>On Sun, Sep 23, 2001 at 01:25:37PM -0400, Rich Bowen wrote:
>> we have taken the approach that if
>> something is indeed a FAQ, then we need to fix the documentation so that
>> folks don't need to A it quite so F.
>
>A FAQ isn't about questions that are frequently asked. It's about what you
>want to tell people. I've never been asked how to declare a structure. And I
>know why I haven't been asked - because the answer's there in the FAQ!
>
>Fixing the documentation assumes that people read something other than the
>FAQ as well.
The structure of the Perl documentation is feature-by-feature. The FAQ
approaches stuff from a "how do I...?" point of view, often drawing in
information which is scattered across the Perl feature set and hence the
Perl documentation. So I don't think that updating the (non-FAQ)
documentation is necessarily a useful or even doable exercise.
K.
--
Kirrily 'Skud' Robert - [EMAIL PROTECTED] - http://infotrope.net/
"So i get the chance to reread my postings to asr at times, with a
corresponding conservation of the almighty leviam00se, Kai Henningsen."
-- Megahal (trained on asr), 1998-11-06
