Make sure to familiarize yourself with the project layout before making any major contributions.
There is a presentation to help you to take your first steps to become a FEDOT contributor below.
How to contribute¶
The preferred way to contribute to FEDOT is to fork the main repository on GitHub:
Fork the project repository: click on the ‘Fork’ button near the top of the page. This creates a copy of the code under your account on the GitHub server.
Clone this copy to your local disk:
$ git clone email@example.com:YourUsername/FEDOT.git $ cd FEDOT
Create a branch to hold your changes:
$ git checkout -b my-contribution
Make sure your local environment is setup correctly for development. Installation instructions are almost identical to the user instructions except that FEDOT should not be installed. If you have FEDOT installed on your computer then make sure you are using a virtual environment that does not have FEDOT installed.
Start making changes on your newly created branch, remembering to never work on the
masterbranch! Work on this copy on your computer using Git to do the version control.
To check your changes haven’t broken any existing tests and to check new tests you’ve added pass run the following (note, you must have the
nosepackage installed within your dev environment for this to work):
$ pytest -s
When you’re done editing and local testing, run:
$ git add modified_files $ git commit
to record your changes in Git, then push them to GitHub with:
$ git push -u origin my-contribution
Finally, go to the web page of your fork of the FEDOT repo, and click ‘Pull Request’ (PR) to send your changes to the maintainers for review.
(If it looks confusing to you, then look up the Git documentation on the web.)
Before submitting your pull request¶
Before you submit a pull request for your contribution, please work through this checklist to make sure that you have done everything necessary so we can efficiently review and accept your changes.
If your contribution changes FEDOT in any way:
Update the documentation so all of your changes are reflected there.
Update the README if anything there has changed.
If your contribution involves any code changes:
Update the project unit tests to test your code changes.
Make sure that your code is properly commented with docstrings and comments explaining your rationale behind non-obvious coding practices.
If your contribution requires a new library dependency:
Double-check that the new dependency is easy to install via
pipor Anaconda and supports Python 3. If the dependency requires a complicated installation, then we most likely won’t merge your changes because we want to keep FEDOT easy to install.
Add the required version of the library to requirements.txt
Contribute to the documentation¶
Take care of the documentation.
All the documentation is created with the Sphinx autodoc feature. Use .. automodule:: <module_name> section which describes all the code in the module.
If a new package with several scripts:
Go to docs/source/api and create new your_name_for_file.rst file.
Add a Header underlined with “=” sign. It’s crucial.
Add automodule description for each of your scripts.
.. automodule:: fedot.core.your.first.script.path :members: :undoc-members: :show-inheritance: .. automodule:: fedot.core.your.second.script.path :members: :undoc-members: :show-inheritance: ...
Add your_name_for_file to the toctree at docs/source/api/index.rst
If a new module to the existed package:
Most of the sections are already described in docs/source/api , so you can:
choose the most appropriate and repeat 3-d step from the previous section.
or create a new one and repeat 2-3 steps from the previous section.
If a new function or a class to the existing module:
Be happy. Everything is already done for you.
After submitting your pull request¶
After submitting your pull request, Travis-CI will automatically run unit tests on your changes and make sure that your updated code builds and runs on Python 3. We also use services that automatically check code quality and test coverage.
Check back shortly after submitting your pull request to make sure that your code passes these checks. If any of the checks come back with a red X, then do your best to address the errors.
This document guide is based at well-written TPOT Framework contribution guide.