On Tue, May 03, 2011 at 12:04 +0200, Antonio Cuni wrote: > On 03/05/11 11:55, holger krekel wrote: > > Hi all, > > > > i created a CNAME for our use of pypy.readthedocs.org and so you can now > > reach pypy docs under the frontend URL of > > > > http://doc.pypy.org > > > > It might be better to promote this link also from pypy.org so > > that URLs have a higher chance to remain valid even if we > > decide to move away from readthedocs some day. > > yes, good idea. > Moreover, I think we should change the link from "Dev Documentation" to just > "Documentation", because it contains docs which are generally useful also for > users (e.g., the getting started, the papers, etc.) > > Alternatively, we could have a heavier refactoring of the documentation and > have clearly separated sections for "user docs" and "dev docs". > > > Moreover, we could see to have (another) sphinx setup for sphinx > > setup for our current pypy.org so we can host it there as well, maybe > > under www.pypy.org -- we need to have a subdomain/CNAME as we cannot > > redirect the root domain to readthedocs. > > I'm not a sphinx expert, but I don't think that the default layout (i.e., with > a sidebar on the left) is the best for the home page of pypy.org.
I think sphinx can be tuned to support pypy.org layout but i don't consider myself a sphinx expert either. Maybe someone feels like helping and trying with https://bitbucket.org/pypy/pypy.org/overview to put it into a sphinx format? holger _______________________________________________ pypy-dev@codespeak.net http://codespeak.net/mailman/listinfo/pypy-dev
