documentation misrendered

[Zooko]

Look at this screenshot. The foolscap docs are messed up. I was about to post about foolscap to the cryptography mailing list, which is why I was looking at it.

[Zooko]

I posted about foolscap to the crypto list: ​http://www.metzdowd.com/pipermail/cryptography/2013-October/018164.html

(John Kelsey is a great cryptographer and was one of the NIST personnel responsible for the SHA-3 project.)

[Zooko]

Here is the page of misrendered docs: ​http://foolscap.lothar.com/docs/using-foolscap.html

[Brian Warner]

We've (finally) reformatted the docs to .rst, with inline code examples (unfortunately not automatically interpolated). Part of the 0.7. release process should be to remove the docs hosted on foolscap.lothar.com and instead direct folks to the github-rendered .rst files at ​https://github.com/warner/foolscap/blob/master/doc/using-foolscap.rst

[Brian Warner]

wiki front page is updated. We'll still need to generate API docs (with epydoc), but we can stop updating the rest of the docs.