Contribute to the Arduino Reference © CC BY-SA

Learn how to quickly contribute to the Arduino Reference via GitHub.

  • 24,909 views
  • 10 comments
  • 43 respects

About this project

The Arduino Language Reference Migration

We replaced the Arduino Language Reference pages with an updated version hosted on GitHub, making it easier for anyone in the community to suggest changes and improvements.

The Arduino Glossary

We have also published online the Arduino Glossary. If you find anything that can be improved or you want to suggest a new term write us on Github!

Next Steps

We are planning on doing the same process with the Library Reference. We will migrate and review all the content on GitHub, gather your feedback, and finally publish it online. Stay tuned for updates on that as well!

How to Contribute on GitHub

We are glad you want to contribute to the Arduino Language Reference or the Glossary—that’s the best way to help the community!

You can contribute content directly on GitHub using their online interface. Below you can find a quick tutorial on how to do that...

You can also follow this guide by the GitHub team to learn how to edit an .adoc file and propose a file change to the Arduino team. When suggesting a change, please adhere to the guidelines described in the Reference template files.

1. If you don't have an account yet, sign up on GitHub.

2. Go to a repository on GitHub. For instance, the Arduino Language Reference in English. Select the file you want to edit by double clicking on the file tree.

3. Click on the Edit button in the upper right corner.

4. You are now ready to modify the file! Just type on it and preview your changes in the Preview tab.

5. When done with your edits, scroll to the bottom of the page, give a name to your contribution, and add an additional description. From there, simply press the 'Propose File Change' button.

6. You will be redirected to the Comparing Changes page. Make sure all your edits are correct. When done reviewing, press 'Create Pull Request.'

7. Time to create your pull request! Add any additional comments, then submit your contribution to the Arduino team for review.

8. That's it! Your edits will be reviewed and hopefully merged into the main repository. They will be available online on the temp Reference page in a few hours.

Thank you so much for your contribution!

9. If you discover that a section is missing in a Reference Language page and want to add it, you can look up the template pages for formatting guidelines and more information on ASCIIDOC.

There are two kinds of template pages:

Multi-Language Support

Migrating all the Reference on GitHub will finally allow us to support multiple languages! Thanks to Akira Tanoue, we already have quite a few pages in Japanese, which are available here if you want to contribute too.

Other languages you can begin contributing to (by translating the English versions) are: Spanish, Italian, German, French... and Portuguese thanks to Robson Couto.

Comments

Similar projects you might like

Lightpipe 7-Segment Display

Project tutorial by Brian Lough

  • 2,058 views
  • 3 comments
  • 6 respects

PENXZYL: Arduino 3-Axis Brush Plotter

Project showcase by Guiye Perez Bongiovanni

  • 4,147 views
  • 4 comments
  • 18 respects

Arduino Spider Robot (Quadruped)

Project tutorial by MEGA DAS

  • 393 views
  • 1 comment
  • 4 respects

Google Chrome Dinosaur Game on 16x2 LCD Shield

Project showcase by brzi

  • 175 views
  • 1 comment
  • 6 respects

Temperature Controlled Exhaust Fan

Project showcase by alan_dewindt

  • 1,268 views
  • 0 comments
  • 9 respects

MyRiver

Project tutorial by Andrei Florian

  • 8,990 views
  • 2 comments
  • 36 respects
Add projectSign up / Login