What Makes Pylons Stand Out As a Web Framework

After 6 release candidates, Pylons 0.9.7 final has been released. Big congrats to all developers. Although it's just a point release, I think this is a huge milestone for Pylons for one reason: It has proper documentation! I've been using both Pylons and Django for several web applications and Pylons' old docs were sparse and hard to navigate. This didn't stop me from digging in and playing around with the framework but for a project to really reach a wide audience it needs well-organized, readable documentation. I can think of many well designed, solid programming tools that have failed because, simply, their docs were not readable. There is a difference between having comprehensive documentation and having documentation that is readable. Django got this right from day one.

As a Pylons user, I'd like to point out a few reasons why I like it and some reasons I don't. It's not meant as a fair comparison to Django, but Django is the only other web framework I know pretty well so it is my point of reference.



As a disclaimer I should point out that I am one of those developers who likes to build low level tools. I certainly reuse existing components when possible but building small tools that do one thing and do it well is fun because it's easy. Pylons fosters this approach to software. Not all developers are like this and I'd say, overall, Django probably offers more of a "batteries included" feeling.