[Catalyst] IMPORTANT: To all Catalyst::Whatever Authors,
please read and ACT
Octavian Rasnita
orasnita at gmail.com
Sun May 11 06:13:49 BST 2008
From: "Kieren Diment" <diment at gmail.com>
> No, users who don't understand how to use the code well enough that they
> have to rely on the documentation need documentation that won't confuse
> them with trivial stuff and unadvertised interaction bugs. YAML in pod
> causes these bugs, which impacts on the learning curve significantly, so
> please don't use it in documentation. If you're still not convinced
> after reading http://en.wikipedia.org/wiki/ Cognitive_load then I'm happy
> to these issues off-list.
The python/yaml style is also harder to understand by a blind Catalyst
programmer, because by default, the number of spaces in a text is not
spoken, so a piece of perl code would be prefered, and any programmer could
understand it and use whatever config module he likes.
Octavian
More information about the Catalyst
mailing list