[python-advocacy] How programming language webpages should be designed

[Jason Baker]

> Jason Baker has interesting thoughts about how programming language
> web sites should be designed, and criticizes python.org for not
> putting code examples on the front page:

It's worth pointing out that I didn't intend for this post to just be
a criticism of python.org.  For the most part, python does all of the
things that I list well... except what is in my opinion the most
important one.

That said, I won't be the person who sits back and criticizes without
trying to change anything.  Here's what I would like to propose:

Have a set of simple examples (on average 4-5 lines, no more than 10)
that demonstrate most of Python's major features  and link to them on
the front page.  Something like this:
http://wiki.python.org/moin/BeginnersGuide/Programmers/SimpleExamples

I like this format because the examples are easy to understand, and
they show off Python's strength:  readability.  I think that most
people who have a bit of programming experience will be able to figure
these out without too much description or even any interactive
interpreter output.

If this is something the community wants to go with, I'm willing to
put time into writing this page.