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.

Gabriel
_______________________________________________
Cython-dev mailing list
Cython-dev@codespeak.net
http://codespeak.net/mailman/listinfo/cython-dev

Reply via email to