Removed the "public API" section from the README.md (nothing is certain yet) and formatted the doc.