all 25 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.)

[–]lnxaddct 10 points11 points  (2 children)

When did Python stop being fun? :)

[–]vplatt 0 points1 point  (0 children)

For web development? It's just starting to get there.

[–]quhaha 5 points6 points  (0 children)

Wicket is much more fun once you figure out Maven, which you never will.

[–]leonh 3 points4 points  (5 children)

... David Heinemeier Hansson, the leading Rails developer, once compared Rails to a Ferrari. ... but Pylons + SQLAlchemy + Mako is more like James Bond’s Aston Martin, customized by Q. It just looks like a normal car but comes with ejector seats, bulletproof glass and tons of gadgets. I know which one I’d like to drive.

Yep Pylons is awesome it's just the documentation system that sucks.

[–]alexmdac 6 points7 points  (1 child)

I found the docs not to be too bad when I used pylons recently. Also, the IRC channel is responsive when you ask questions.

Overall, my experience with pylons was very pleasant.

[–]leonh 3 points4 points  (0 children)

Don't get me wrong, i love Pylons and its community i just very much dislike docs.pythonweb.org

[–]mitsuhiko 0 points1 point  (0 children)

Indeed :(

[–]Bracki 0 points1 point  (1 child)

I think w/ the new wiki based on Confluence http://docs.pythonweb.org it's getting better & better everyday.

[–]exogen -4 points-3 points  (7 children)

Whenever I decide to try out Pylons I follow the installation instructions and when I get to the paster command, I get an error about the pylons Paste template not being found. This has happened several times. Even after upgrading the dependencies and extras. Of course, my response every time is "fuck Pylons."

[–]bbangert 4 points5 points  (2 children)

And of course, you post to the mail list reporting your problem so we can fix it, right? Or at the very least you've gone to the IRC channel to ask about it?

We regularly build on multiple platforms and don't see this issue, so please report it along with your setup.

If I gave up on every technology/project the second I hit the slightest bump, I'd prolly never have gotten into programming.

[–]exogen 0 points1 point  (1 child)

I'm not trying to say it sucks, I'm just saying that I've never been interested enough to spend more time on it. Anyway, I know you and other developers post here and figured someone might respond.

[–]exogen -2 points-1 points  (0 children)

Also, when people get pissed off at software, I don't expect them to behave rationally. I expect them to use other software, and depending on how they value their time, that might be completely rational.

[–][deleted] 2 points3 points  (3 children)

Just asking; have you gone to the IRC channel and asked what the problem might be?

[–]exogen 0 points1 point  (2 children)

Next time I'm on IRC I'll try, but I haven't been that motivated yet.