On Sep 30, 2008, at 12:34 AM, Dag Sverre Seljebotn wrote: > Gabriel Gellner wrote: >>> I think this could be done, or would it be better to host the >>> docs on >>> cython.org itself? >>> >> I have no opinion, they both seem equally fine to me. >> >>>> Socially, let's see if other people also like your docs as the >>>> default >>>> docs for Cython. >>> I do! Given that there aren't any "default" docs now, unless there's >>> objection (that would be a real suprise) let's use them now. >>> >> Great! >> Someone just tell me where to upload the generated docs, and I >> will do so. >> I can also have a pre built pdf linked to in the html docs. > > An opinion: Ideally (to follow Fernando's request, which I agree with) > > a) docs is moved to a subdirectory of the normal cython repo
See below. > b) A script to build them is shipped with Cython (setup.py could do > this > I suppose) If Sphinx is detected, and it's fast. I certainly don't want it to be a requirement. > c) On each release, Robert runs a script on the server which generates > those html and docs in a subdirectory for the release, and updates the > current link to the docs. I agree with Gabriel that at this point we are simply trying to make docs for Cython, the difference between versions being miniscule compared to the incompleteness that has been there. I am also excited for rapid progress on this front and if it is decoupled with the codebase to make this easier, it is certainly worth it for the moment. When things stabilize, we'll move over to the new model. - Robert _______________________________________________ Cython-dev mailing list [email protected] http://codespeak.net/mailman/listinfo/cython-dev
