Improve registry and index REST API documentation

I've been working on a private Docker index (stackmachine.com), and found some of the documentation for outdated. Here's my first attempt at clearing up some of the docs.