But we can make it better.

- can ``make html`` from doc directory and get html.

- documentation tests run as part of normal tests.

README.rst needs some love.

Then on to making this work with RTD.

Setup and reference

Reference docs

and fix a ReST issue.

Also the details aren't important here, so moved to a footnote.

Still need to discuss zconfig

Writing persistent objects

See http://stackoverflow.com/questions/9153473/sphinx-values-for-attributes-reported-as-none/39276413

Merge branch 'writing-persistent-objects' of github.com:zopefoundation/zodbdocs into writing-persistent-objects