diff options
author | Aaron LI <aaronly.me@outlook.com> | 2016-09-09 21:50:58 +0800 |
---|---|---|
committer | Aaron LI <aaronly.me@outlook.com> | 2016-09-09 21:50:58 +0800 |
commit | fc2724a4cde7f0ff2aa724b9a63d67e7f98a47b4 (patch) | |
tree | a4f3630e1bba2872fd1abf019dea77b58366cee8 /CONTRIBUTING.md | |
parent | 6a094683ac7a44f44ec74dc4b86972de3dea5e42 (diff) | |
download | fg21sim-fc2724a4cde7f0ff2aa724b9a63d67e7f98a47b4.tar.bz2 |
Minor revisions to CONTRIBUTING.md
Diffstat (limited to 'CONTRIBUTING.md')
-rw-r--r-- | CONTRIBUTING.md | 16 |
1 files changed, 9 insertions, 7 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 4936447..370d178 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -6,8 +6,8 @@ Issues The GitHub Issues is used to track the development progress, issues, bugs, feature requests. -However, the installation and usage related problems should NOT go to -the Issues, and the Wiki (TODO) or mailing lists (TODO) can be adopted +However, the installation and usage related problems *should not* go to +the Issues, while the Wiki (TODO) or mailing lists (TODO) should be adopted for those purposes. @@ -86,17 +86,19 @@ Code Guidelines ### Python Adhere to the [PEP 8](https://www.python.org/dev/peps/pep-0008) code style -and also take a look at this -[code style](http://docs.python-guide.org/en/latest/writing/style/) from -[The Hitchhiker's Guide to Python](http://docs.python-guide.org/). +(also a [much prettier version of PEP 8](http://pep8.org)). +And the [code style](http://docs.python-guide.org/en/latest/writing/style/) from +[The Hitchhiker's Guide to Python](http://docs.python-guide.org/) is worth +reading. -It is strongly recommended to check the code with [``flake8``](https://gitlab.com/pycqa/flake8) which wraps ``pep8``, ``pyflakes``, and other checkers together. +It is strongly recommended to check the code with [``flake8``](https://gitlab.com/pycqa/flake8), +which wraps ``pep8``, ``pyflakes``, and other checkers together. So make sure it is installed before carrying on. * Vim users: 1. Recommend to install the [``spf13-vim``](https://github.com/spf13/spf13-vim) - configuration distribution, which already integrates the great + configuration distribution, which already integrates the nice [``syntastic``](https://github.com/scrooloose/syntastic) syntax checking plugin; |