Updated contributing guidelines // Resolve #2820

This commit is contained in:
Ivan Kravets
2019-07-24 12:08:21 +03:00
parent 8ea3909a64
commit 436a6bc521

View File

@ -4,18 +4,18 @@ Contributing
To get started, <a href="https://www.clahub.com/agreements/platformio/platformio-core">sign the Contributor License Agreement</a>.
1. Fork the repository on GitHub.
2. Make a branch off of ``develop``
3. Run ``pip install tox``
4. Go to the root of project where is located ``tox.ini`` and run ``tox -e py27``
2. Clone repository `git clone --recursive https://github.com/YourGithubUsername/platformio-core.git`
3. Run `pip install tox`
4. Go to the root of project where is located `tox.ini` and run `tox -e py27`
5. Activate current development environment:
* Windows: ``.tox\py27\Scripts\activate``
* Bash/ZSH: ``source .tox/py27/bin/activate``
* Fish: ``source .tox/py27/bin/activate.fish``
* Windows: `.tox\py27\Scripts\activate`
* Bash/ZSH: `source .tox/py27/bin/activate`
* Fish: `source .tox/py27/bin/activate.fish`
6. Make changes to code, documentation, etc.
7. Lint source code ``make lint``
8. Run the tests ``make test``
9. Build documentation ``tox -e docs`` (creates a directory _build under docs where you can find the html)
7. Lint source code `make lint`
8. Run the tests `make test`
9. Build documentation `tox -e docs` (creates a directory _build under docs where you can find the html)
10. Commit changes to your forked repository
11. Submit a Pull Request on GitHub.