Update Readme + doc for clarity and style