[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