From docs@:

"""
The howto-advocacy is interesting.

You might consider removing the following sentences, which I found personally gave me a negative impression:

"python hasn't had all the publicity" to my mind gives the impression that python is not popular.

"python is definitely not a toy language that only usable for small tasks". This gives to me the impression that you feel many people think it is.

Section "who's going to support it?" a company needs to be able to call someone, pay for support right now, within one hour, not on a maybe basis. I feel either remove this section or suggest links to three companies providing python support.

Section "python is freely available , how good can it be?" I felt what I wanted to see was not that Linux and apache are good, but why python is good.
"""

I think the advocacy howto was written quite a while ago and could use a makeover.

I would rather the page be removed, at least from the official docs. I wonder how useful it actually is, and as already pointed, it really feels outdated (and Apache is not kool no more).

I suggest just dropping this HOWTO.  

It was written to contrast using Python with using only a low-level language such as C.  Today there may still be some people arguing over whether to use a low-level or high-level language, but I think the idea of using high-level languages has certainly won out.  An advocacy howto written today would be completely different.  

Today we're more likely to write an advocacy micro website instead of a howto, so we should just discard this document.

That's great to hear, especially coming from the author.

New changeset 2ddfa8dbed1d by Ezio Melotti in branch '2.7':
#17729: remove the outdated Advocacy HOWTO, as suggested by the author.
http://hg.python.org/cpython/rev/2ddfa8dbed1d

New changeset a4804e0d4479 by Ezio Melotti in branch '3.3':
#17729: remove the outdated Advocacy HOWTO, as suggested by the author.
http://hg.python.org/cpython/rev/a4804e0d4479

New changeset f9a58f0203b6 by Ezio Melotti in branch 'default':
#17729: merge with 3.3.
http://hg.python.org/cpython/rev/f9a58f0203b6

the index file also needed changing; see attached

New changeset 990c1bd26ef1 by Ezio Melotti in branch '2.7':
#17729: remove the Advocacy HOWTO from the index.
http://hg.python.org/cpython/rev/990c1bd26ef1

New changeset a4d294539f2e by Ezio Melotti in branch '3.3':
#17729: remove the Advocacy HOWTO from the index.
http://hg.python.org/cpython/rev/a4d294539f2e

New changeset ceb1ee4bc214 by Ezio Melotti in branch 'default':
#17729: merge with 3.3.
http://hg.python.org/cpython/rev/ceb1ee4bc214

Fixed, thanks for noticing that and for the patch!