Dear Python, Why Are You So Ugly?

It was posts like this that made me decide to learn Python instead of Ruby, many years back when I was trying to decide what new scripting language to learn.

I could not find any particular programming advantage of Python over Ruby or vice versa. But from the blog posts it was obvious which community I liked much better:

Python's were to the point and technical, if making comparisons with Ruby they'd say they're both powerful languages and pick the one you like best.

Ruby's blog posts were so much more about imago, "personality" and pointing out whatever (even irrelevant) attributes to prove that their thing was better than the other. Not so much Python vs Ruby btw, but also Ruby library X vs Y, or Ruby blogger P vs Q--it felt like everything in the Ruby community was some sort of popularity contest.

On another note, I do agree that Django's website is a mess. And so are its docs, you're much better off using a great IDE like PyScripter and sail through the source code (not saying that's a good thing, on the contrary, just a bit of advice to anyone using Django ;-) ). But Django is hardly the only web framework out there.

There's also a bunch of really nice and clean Python sites out there. I really like the looks of Armin Ronacher's stuff, for instance Jinja2.

I have to strongly disagree on the documentation. The Python online documentation for the language (http://docs.python.org/reference/index.html) and the standard library (http://docs.python.org/library/index.html) are a pleasure to read and navigate. And, easily Googlable; the search "python docs x" on Google usually has the Python documentation for x as the top hit.

What do people gain by writing ill informed, flame bait artictles?

http://docs.python.org/

Official python docs are a class of its own - browse online, higher in google results, download static files, offline searching, well organized, curated content with a lot of example code etc etc.

http://ruby-doc.org/

Ruby docs don't even come close. I have been told ruby docs are mostly a volunteer effort and one man operation, and I mean no offence to whoever is the maintainer, but it isn't comparable to python's.

I haven't tried interactive python tutorial, but the official python tutorial is the best tutorial I have read.

http://docs.python.org/tutorial/index.html

I program comfortably in a number of langauges, and have read a lot of code and documentation. If I have to choose top language tutorials among c, c++, java, perl, python, erlang, lua, javascript, c#, it will be a tie between python's and "Learning Perl".

https://docs.djangoproject.com/en/1.4/

Django's documentation is one click away from the landing page, and the link is located where it is expected to be. Are you seriously telling me you had a problem finding the docs or the download button(so called usability problem)?

FWIW, I find rails guide better than django docs, but that doesn't make the django docs unusable or bad.

http://guides.rubyonrails.org/

http://ringce.com/hyde Jekyll's counterpart is hyde. A simple google search for "python jekyll" would have told you that.

Comparing Google App Engine to Heroku or DHH's landing page Adrian's, and concluding Python is ugly is ridiculous. To be honest, I find the whole article ridiculous.

I have nothing against design and people making pretty shit. I just take exception to lame claims about a language's usability based on how pretty the landing page looks. And in the case of python docs and django tutorials, it doesn't even look bad, and is perfectly usable.

Misleading title. Link Bait.

What does the aesthetics of a web page have to do with the quality of the language?

If the usability is in question, that's one thing -- but the author isn't arguing the less "Sexy" (his words) sites are less usable, simply less attractive to him.

Who cares? If you pick a language based on the sexiness of various websites that are related to the language, you are probably not in the right role.

Here's an anecdote:

In my experience, finding something in Python docs takes a total of five seconds, including passing through the "Google gateway".

Finding something in Rails reference has been downright impossible. This is a function of Ruby itself, a very magical language, magic that fails to communicate in auto-generated documentation. How does this work? Good luck finding out, but you'll feel very clever three hours from now.

Admittedly, I've had very limited exposure to Rails, but perhaps that makes my experience even more relevant.

This reminds me of the jQuery docs situation. Every month or so somebody comes up with an alternative way to access them that's flashy and uses <div> frames with low contrast text and lots of shadows and gradients. I play with the site for 60 seconds thinking "this is neat", and then go back to using the official docs because they come up in a Google search.

I don't think I've ever actually accessed the Python docs in any other way in fact. Same goes for Django. They're clean, static HTML, totally trivial for search engines to index and you always get just what you think you're getting when you click over from a search engine.

Also, unrelated: I learned something today. I read the claim that Python and Ruby are roughly the same age and thought "no way, Python is old-as-hell, Ruby can't be nearly as old". But then Wikipedia pointed out that Python is only 4 years older (1991 vs. 1995).

(Disclaimer: I'm the author of one of the books linked at the end of the post.)

Design is not just important for usability, but also for marketing. If you have an awesome framework, you have to get the word out so people know about it and want to use it. It's not the same kind of marketing a business uses because it's not directly tied to revenue, but it is important if you want said framework to be used and its surrounding community to grow.

How many blog posts do you see complaining about or even advocating the new framework hotness? People are jumping ship to Node.js now and saying Rails sucks, and there's consistently a new framework du jour. I'm not saying that's a good thing, but it is definitely proof that marketing affects framework adoption.

I know it sounds kind of scummy to talk about marketing OSS. The point isn't to position Python as the sexy new language everyone needs to switch to, but to represent the community and quality tools and knowledge it offers. If a new programmer visits the Django site and then the Rails site, might they assume Django is a smaller community because the site isn't as pretty? Maybe the first impression is that Django isn't as well maintained, when we all know that's not true.

The astounding number of devs asking "who cares?" sums up one of my biggest pet peeves. Would you buy a car that had a modern engine but a chassis and interior from 1983? Maybe if you wanted to save a few bucks - but your friends would still tease you for owning an old clunker.

True, Python is a beautiful language that's stayed modern in the face of the evolving web, and I've come across many Python sites that do look really slick. But if the face of the Python community tends to lean towards the look and feel of 1997 Geocities pages, where are new developers going to flock? If you care about your community you should foster it by showcasing the fact that Python more than keeps pace with the modern web instead of subconsciously suggesting to budding programmers that your language is stuck in the 90's.

Also, PHP community, I'm speaking to you as well. Your PHP homepage, pecl, and pear sites (although easy enough to navigate) are in desperate need of a modern design.

There seems to be certain amount of confirmation bias in the post. He started with the premise that python resources are ugly, then found examples that proved his point. If you look at his twitter feed, he was asking for particular resources/pages that confirmed what he already thought.

> Dear Python, Why Are You So Ugly?

Well, once upon a time Python had a beautiful documentation website with lovely illustrations and cute stories. But then the fairy princess elf who made it threw a hissy-fit, disappeared from the Internet and took all their content offline with them, without telling anyone why.

Ever since then we've been recycling Monty Python jokes, because hopefully John Cleese is above that sort of thing.

Some minor nitpicks first:

1. Blogofile is a de facto abandoned project. The project's inherent bugginess is a testament to the fact that the author had more important priorities to address than the design of the site.

2. Comparing Google's App Engine with Heroku is absurd and seems like a sign that the number of data points is so small that comparisons don't make much sense in the first place.

I agree that Python sites look hideous - and have often wondered whether someone should make an alternative style sheet - but I have a feeling the Python community's problem is not that of design, but legacy. As bland as Django's and Python's documentation looks, Pythonistas have come to learn where things are and how they work.

I don't know if migrating the websites of Django and Python to something new would be a good idea, especially when it comes to preserving links for directing to dead ends.

I'd rather that someone did a CSS userstyle than to see the sites get redesigned, because I think it would break more than it improves. If the CSS and HTML could be improved without any changes to URLs, then that would be even better, of course. We can't pretend the changes aren't retroactive.

Maybe someone could do a fork of the sites and apply the changes they want?

As someone said, maybe the Python people just decided to spend their time writing good documentation instead of creating a good-looking front-end? There are only so many people and resources to go around, especially in one-man projects like Blogofile. As chance would have it, I actually use Blogofile over all the alternatives, meagre design or not. Maybe I share sensibilities with the Blogofile and Python guys that don't translate to good-looking websites?

Really guys, I'm all for beautifully designed pages and stuff, but when you use page design to judge between two things in which design will probably not interfere I think that the hipsterness went too far.

That OP is cherrypicking is obvious, but his web shop example is particularly brazen.

Google for 'django consulting' also turns up on first page:

http://www.comfychairconsulting.com/

http://tivix.com/

http://www.caktusgroup.com/

Linkbait with a main course of generalization and ample sides of selection bias. OP is a Python/Django shop -- if this is intended as a call to arms it is severely misguided.

What does web design have to do with the actual languages? All you've proven is that Ruby developers spend more time on HTML and CSS.

With regard to docs, as of May 2011

  "With revision 31499 of trunk RDoc reports that just 
  under half of ruby has not even a single character of
  comments with over half of the classes and modules
  missing documentation"

Source: http://blog.segment7.net/2011/05/09/ruby-1-9-3-documentation...

Given finite developer resources, I'd rather have docs over shiny. The Python community has its priorities straight.

Probably the most stupid thing I have read in a long time. Thanks.

Maybe because python has been around a lot longer than rails which is when ruby really exploded. Newer web design techniques allow for better looking websites.

Maybe because there are more real programmers in the Python community :)

Joking aside design is a visual representation of quality. For newcomers a better design might be all is needed to attract them. I guess then you can also argue why many In Ruby world are rather shallow :p

Am I the only one who read this article and thought a designer with no sense of programming skills is talking, over an actual programmer?

Sure, it's a provocative title, but the post is clearly not about comparing languages as languages - he's using programming languages as a grouping variable for people and their websites. It's a terrible post if you're trying to learn something about the two languages, but a great post if you're interested in seeing examples of how design aesthetics might correlate with chosen programming language communities.

To all the people criticizing the post, please realize this has little to do with computer science and is almost entirely sociology. It's not a particularly rigorous "study", but it's not really trying to be be.

In defense of Python:

* Rails' website has the design might of 37signals behind it. Most things look bad in comparison. To be fair, Django's website isn't great. Maybe compare Sinatra and Flask's websites too?

* Comparing the personal webpages of the guys behind the main frameworks seems pointless.

* I host Python code on both Heroku and GAE (Heroku isn't only for Ruby). Heroku might be more designed, but GAE certainly isn't ugly, and I think I prefer their documentation.

* Have you compared the official websites for Python and Ruby? I know which one I prefer. Python's documentation is excellent.

I know this is an appeal to authority and past success if no guarantee of future success... but the Django homepage was designed by Wilson Miner (http://wilsonminer.com/) who also originally designed the Apple homepage among other things.

Years ago when I was learning to code I chose Python over Ruby (and Java, etc) because of the aesthetics of the code. Python is so pleasing to look at on the screen.

I tend to agree with the premise of the article. I've thought the same for years.

Ignoring the misleading title; who cares? As long as the documentation/information is easy to get to and digest, who cares how the primary website looks?

The only area of python (specifically Django) I consider "ugly" that actually has any impact on the user is the default admin area. Fortunately there are projects like Grappelli (https://github.com/sehmaschine/django-grappelli) that help alleviate that.

Rails grew up in the design community (led by 37 Signals) so the current situation makes sense. I'm not sure it's that bad but there is probably room for improvement. Some may even appreciate the sparer aesthetics in the Python world.

The one I think wish is that Sphinx had a better design. There's something attractive about its simplicity but I have the hardest time navigating around.

I think it's worth pointing out that you can deploy Python webapps to Heroku and Dotcloud [1], not just GAE. And for blogging software: Hyde [2] is just as well designed and equivalent in functionality to Jekyll.

[1]: https://www.dotcloud.com/

[2]: http://ringce.com/hyde

Having built sites in Rails and Django, I far prefer the Django docs in terms of content and visual style.

Ahem... "Usability".

What a terrible article. Aesthetics are not the core of design.

Is this really a python issue, or a ruby specialty? If you look at programming resources for any language but ruby, I'll bet they're more like the python pages linked there than the ruby ones.

I suspect that ruby just has an especially beauty and design focused culture. Python is a little more old school. This might drive some people away from python, but there are other things that drive them to it.

I prefer the style of Python to the ones of Ruby anyday.

I also prefer the style of Hackernews/Reddit to the one of Digg. Digg may look better, but its style and content is what i don't like.