Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse code

Add todo.txt with some background.

  • Loading branch information...
commit 6f24ed3e123bb562a46601eaace8a25ff87ec901 1 parent 6f31ea8
Robert Bradshaw robertwb authored

Showing 1 changed file with 24 additions and 0 deletions. Show diff stats Hide diff stats

  1. +24 0 todo.txt
24 todo.txt
... ... @@ -0,0 +1,24 @@
  1 +Background
  2 +----------
  3 +
  4 +[brain dump]
  5 +
  6 +The "Old Cython Users Guide" is a derivative of the old Pyrex documentation. It underwent substantial editing by Peter Alexandar
  7 +to become the Reference Guide, which is oriented around bullet points
  8 +and lists rather than prose. This transition was incomplete.
  9 +
  10 +At nearly the same time, Robert, Dag, and Stefan wrote a tutorial as
  11 +part of the SciPy proceedings. It was felt that the content there was
  12 +cleaner and more up to date than anything else, and this became the
  13 +basis for the "Getting Started" and "Tutorials" sections. However,
  14 +it simply doesn't have as much content as the old documentation used to.
  15 +Eventually, it seems all of the old users manual could be whittled
  16 +down into independent tutorial topics. Much discussion of what we'd
  17 +like to see is at
  18 +
  19 +http://www.mail-archive.com/cython-dev@codespeak.net/msg06945.html
  20 +
  21 +There is currently a huge amount of redundancy, but no one section has
  22 +it all.
  23 +
  24 +Also, we should go through the wiki enhancement proposal list and make sure to transfer the (done) ones into the user manual.

0 comments on commit 6f24ed3

Please sign in to comment.
Something went wrong with that request. Please try again.