Clever is mostly an open source and open hardware project aimed at lowering the entry threshold to development of the projects related to flying robotics. You can contribute to the project by offering fixes and improvements for Clever documentation and software.
To offer changes to Clever documentation or SW, you should have an account at GitHub.
All Clever documentation is written in the widespread Markdown format. There are many Markdown guides on the Internet.
In Russian: https://guides.hexlet.io/markdown/.
We also recommend using the Code Spell Checker VScode plugin.
For a local build of a static documentation website, use the
If you have found an error in the documentation or if you want to improve it, use the Pull Request mechanism.
- Find a file with the article you want in the repository – https://github.com/CopterExpress/clever/tree/master/docs.
Make the necessary changes.
- Click "Propose file change".
- Describe the change you have made, and click "Create a Pull Request".
- Wait for your changes to be approved :)
If you've made your own project based on Clever, you can add an article about it to the "Clever-based projects" section.
Prepare your article and send it as a pull request to the Clever repository.
Fork the Clever repository:
Check out the freshly-forked repository on your computer:
git clone https://github.com/<USERNAME>/clever.git
Open the directory with the source code checkout and create a new branch for your article (for example,
git checkout -b new-article
Write a new article in the Markdown format and save it in the
docs/enfolder (for example,
- Place additional visual assets in the
docs/assetsfolder and add them to your article.
Add a link to your article to the appropriate section in the
SUMMARY.mdfile (in the same folder as in the fourth step):
... * Supplementary materials * [COEX Pix]( ) * [Contribution guidelines]( ) * [New article]( ) * [RC troubleshooting]( ) * [Flashing ESCs]( ) ...
Commit your changes locally:
git add docs/ git commit -m "Add new article for Clever"
Upload your branch to your forked repository on GitHub:
git push -u origin new-article
Open your repository on GitHub and send a
pull requestfrom your branch to Clever:
Wait for the review, be ready to make changes if needed.
- Look at your new and useful article at https://clever.coex.tech !