Docs Review

[Byron]

Overhaul docs by check examples, check looks, check for typos. The docs review should be done before any release is getting official.

Also make sure all api docs are being generated, hence some resT syntax errors need fixing.