adding better linting and docs for checks install

[vsoch]

it was not clear pip install with the checks variant was needed for check

• This will close #63

I am also using the opportunity to add better linting.

Signed-off-by: vsoch [email protected]