markdown guide

We have flake8 script running as part of bitbucket pipelines. That sometimes will catch syntax error or using undefined name before we manually run our tests. For now we can't run our test suite as bitbucket pipelines as the tests must be run from within our environment.