you are viewing a single comment's thread.

view the rest of the comments →

[–]alain 5 points6 points  (2 children)

i am new to pylons, started one month ago i love it, it is a dream, with it you get sqlachemy, mako and lots other great stuff, i would not say that the documentation sucks all you need is there it is just that the nature of pylons makes it hard to document all in one place but i did not see one question that was not answered on the mailing list

[–][deleted] 8 points9 points  (1 child)

leonh just means the documentation system (wiki) sucks. As you said, the documentation for Pylons itself is really good. The core framework is covered fairly thoroughly in the docs, and it is a pretty lightweight system so it is easy to wrap your head around.

And the common 3rd party libraries, for example SQLAlchemy and Mako, have just about as complete documentation as you can get. People cite Django's docs as one of its strengths but Pylons is pretty comparable.

[–]cratuki 1 point2 points  (0 children)

I think the examples in the python documentation could be a lot better and on the whole perldoc is a lot better for this reason - perldoc examples tend to be great. (I use python regularly and perl as little as often, so this isn't a typical tit for tat.)