more docs, format and rename methods that are private api
2.0.2