First attempt to automate documentation-building.

I can't deal with writing the same docs twice; in both the code and the readme.
Restructured documentation, use automatic extraction from code for the API.

This is way more DRY, which really is a lot better, perhaps expecially for documentation.
Deleted, since I switched to .md extension for brevity.
Make README.md be the "official" source-distributed readme.

This replaces the symlink to the same file, called README.
Add the new README.md file, which is now auto-generated.

This needs to be added since we want it shown by GitHub.