Update README.md with latest information about project's modules and API

This PR incorporates work by @schnaigs to bring the README up-to-date. There isn't an associated issue.