<subjective part> I ***LOVE*** the tight integration of web2py components.
I ***LOVE*** the compactness of web2py. I ***HATE*** over-abstracted, over-engineered, over-complicated, Java- style enterprisey code. YAGNI, KISS, "less is more" are hard-earned parts of developer wisdom. Most of the web frameworks somehow derailed their trains from the lean track. Most of them follow a wrong set of _dogmas_. Weheh said: "Web2py is wonderful because of its simplicity, consistency and performance." YES, and of its security, and of its backward compatibility, and... and... and... </subjective part> <objective part> Selecting developer toolset is a matter of taste. Obviously. Always. If you abominate from web2py, don't use it. </objective part> <!!!!!!!!!!> Web2py has a single, but big weak point: scattered, hard-to-follow documentation. The importance of up-to-date, detailed, clear documentation is undeniable. Undocumented features are similar to untested code. Out-of-date docs are similar to buggy code. Most programmers hate writing documents. But writing docs is *easy*: * It is error prone? Errors are fixable, docs are never perfect! * It is time consuming? Write some *short* sentences after succesful coding! Be proud, praise your work! * It is difficult to write in clear, concise, elegant style? Then write some foggy, verbose, clumsy fragment. Somebody, some time will make it clear, concise, elegant. Good documentation has two mains parts: * A wiki to keep the front. With *all* of the usable informations, details and fragments. [MISSING BADLY]. * A book for beginners, to ease the start, to stimulate the appetite. [CHECK]. Toss details into the wiki, reference them in the book. [THIS IS A TRICK, NOT A REQUIREMENT]. </!!!!!!!!!!> -- You received this message because you are subscribed to the Google Groups "web2py-users" group. To post to this group, send email to web...@googlegroups.com. To unsubscribe from this group, send email to web2py+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/web2py?hl=en.
