I'm still not sure about the intended workflow:
1. wsgi.org content repository is on github which is developer friendly.
But, who decides about write access? In pratice, this might not be
a problem though, because it's only a handfull people anyway, who
are actively contributing.
2. The actual pages (sphinx?) should then be hosted by ReadTheDocs?
Where does the wsgi.org domain come into play? Does ReadTheDocs provide
virtual (apache) hosts? We can't just point wsgi.org to ReadTheDocs.org,
right? Or should we just have a static page on wsgi.org that contains a
link to ReadTheDocs?
Stephan
Am 10.09.2011 17:04, schrieb Graham Dumpleton:
I'll see if I can find someone at the DjangoCon sprints who might be
able to give suggestions of what to do. The sprints are at the offices
of Eric from ReadTheDocs, so one would think I might be able to get an
answer.
On 10 September 2011 06:36, Masklinn<maskl...@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
_______________________________________________
Web-SIG mailing list
Web-SIG@python.org
Web SIG: http://www.python.org/sigs/web-sig
Unsubscribe:
http://mail.python.org/mailman/options/web-sig/archive%40mail-archive.com
