Recently I did a couple of open source contributions. I decided to document my learning here.
In this pull request I updated the contributor documentation for
For anyone who is working in python for a while is already familiar with
flake8 It could be described as a “linter” that checks style and quality of
Officially it describes itself as :
a python tool that glues together pep8, pyflakes, mccabe, and third-party plugins to check the style and quality of some python code.
The change was minor documentation change asking contributor to not include
.gitignore in their PR.
The documentation gives them option to use a global
What I learnt
I did not know about either of the alternatives. Global
I also used reStructuredText (
.rst) after a long time. Had to struggle a little
bit with muscle memory of using markdown.
I also got to brush up on sphinx. I had used it a while ago to generate my project’s documentation.
The Pull Request
For your reference, you can see the PR itself here