Further documentation update

[balazagi]

Updates required to documentation after the 20/05/20 meeting:

• update reference to PEP8 and flake8 instead of pylint
• in the Some good Git best practices section move up the Use branches to first bullet point
• ...

[balazagi]

closing this issue as it has now been reviewed and merged