On 3 Nov 2011, at 19:03, will trillich wrote:
In order to have 'perfect documentation' it must meet two criteria:
A) explain the utility and usage (benefits and how-to) in a way that
I can grok and B) show up on my radar in my searches. Both of these
depend a helluva lot on my own activity and context, making
compliance impossible. :)
Sometimes scar tissue is the only (best?) way to really learn.
Sure, I totally agree.
I'm also entirely certain that the documentation as it stands fails at
meeting (or at least is way before the standard it could be) in your
criteria for (A), and therefore will fail to meet a good many other
people's version of the same criteria.
As someone who has 'just got it', you are absolutely the best placed
person to modify the documentation to add to the benefits (and maybe
provide an example) as to make it more clear to people, so that the
documentation _will_ fulfill that criteria for a broader range of
people who happen to read it in future.
Cheers
t0m
_______________________________________________
List: Catalyst@lists.scsys.co.uk
Listinfo: http://lists.scsys.co.uk/cgi-bin/mailman/listinfo/catalyst
Searchable archive: http://www.mail-archive.com/catalyst@lists.scsys.co.uk/
Dev site: http://dev.catalyst.perl.org/