linting and docs updates

Signed-off-by: Adrian-Tudor Panescu <adrian@panescu.com>