[Cython] Porting the Docs

[Robert Bradshaw]

On Apr 30, 2008, at 8:39 AM, Gabriel Gellner wrote:

> So I have finished the first rough mockup, which mainly consists of  
> getting
> the markup correct. There are still some rough edges, mainly with  
> tables, and
> some of the latex output, but in the spirit of release early  
> release often ;-)
>
> Check out the html at:
> http://www.mudskipper.ca/cython-doc
>
> Get the pdf at:
> http://www.mudskipper.ca/cython.pdf
>
> And finally get the source at:
> http://www.mudskipper.ca/cython_doc.tar.gz
> or
> http://www.mudskipper.ca/cython_doc.zip
>
> Again I would appreciate any comments on if I am screwing up  
> authorship. Down
> the road I think it would be good to attribute everything to the  
> 'Cython Doc
> Team' and have a page that lists contributers. To do this we should  
> make the
> license and authorship on the wiki more explicit. Tell me what you  
> think? I am
> no lawyer, and certainly don't want to piss anyone off who has put  
> the hard
> work into documenting either cython or pyrex.
>
> My plan for the next steps (in order of importance, any comments):
> - Make a PyGments lexer for cython/pyrex so we get nice color coding.
> - Fix up the latex style file so that boxes are not messed up when  
> we have
>   code examples.
> - Put on my writing hat, and do an overhaul of the structure of the  
> docs so
>   that it is faster to navigate. I will be using the python doc  
> structure as a
>   reference.
> - Get some simple howto's written.
> - Thinking if there is an easy way to test the cython code in the  
> docs so that
>   I can ensure accuracy.

Thanks again for putting these all together in a nice form. While  
browsing I noticed some inaccuracies (often just dealing with the  
differences between Cython and Pyrex). Should I send them directly to  
you, or should we set up some revision control (need not be  
centralized).

- Robert