[Web-SIG] Move www.wsgi.org to Read The Docs

Graham Dumpleton graham.dumpleton at gmail.com
Sun Sep 11 00:30:03 CEST 2011


Just change:

:Title: Waiting for File Descriptor Events
:Author: Christopher Stawarz <chris at pseudogreen.org>
:Discussions-To: Python Web-SIG <web-sig at python.org>
:Status: Proposed
:Created: 11-May-2008

to:

Waiting for File Descriptor Events
========================

:Author: Christopher Stawarz <chris at pseudogreen.org>
:Discussions-To: Python Web-SIG <web-sig at python.org>
:Status: Proposed
:Created: 11-May-2008

and it should be fine,

The table of information is only special if at the very start of the
document. So, move title out of the table and put it first as normal
title with underlining of some description so know it is title.

Graham



On 10 September 2011 06:36, Masklinn <masklinn at masklinn.net> wrote:
> On 2011-09-10, at 11:45 , Stephan Diehl wrote:
>>
>> How far are we in getting things ready at the ReadTheDocs end? I'd say, the earlier we can switch the DNS entry, the better.
> Everything was ported (as of August 28 anyway)[0], except for the specifications: from what I can tell, Sphinx does not support PEP-RST[1] (it does not understand the PEP header directives, so they are not displayed in the output), I did not get any answer when I asked about it on the pocoo IRC channel and google searches have failed to yield any information.
>
> Way forward I'd see would be adding a target to Sphinx's makefile to use Docutils directly to compile the PEPs, and linking to them as if they were static HTML documents, but I do not know if RTD supports that. You'd have to ask someone more knowledgeable (Graham has already ported the mod_wsgi docs so he might know). From RTD's documentation, it seems accounts can be whitelisted for code execution[2], Graham probably wouldn't have any issue getting flagged for a pair of bilding commands (and barring that, the compiled PEPs could always be committed to the repo).
>
> In the long run, having a pep sphinx extension might be nice.
>
> [0] https://github.com/GrahamDumpleton/wsgiorg
> [1] https://github.com/GrahamDumpleton/wsgiorg/issues/11
> [2] http://read-the-docs.readthedocs.org/en/latest/faq.html


More information about the Web-SIG mailing list