From: "Kieren Diment" <[EMAIL PROTECTED]>
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 _______________________________________________ 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/
