Contribute to the Arduino Reference © CC BY-SA

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

  • 2,252 views
  • 5 comments
  • 12 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. f 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

Pac-Man LED Pixel Panel Costume

Project tutorial by Ben Muller

  • 4,641 views
  • 3 comments
  • 82 respects

LoRa Gateway for DeviceHive

Project tutorial by DeviceHive IoT team

  • 1,231 views
  • 2 comments
  • 17 respects

IoT Bird Feeder with Sigfox and Tweeter

Project showcase by Gaël Porté

  • 347 views
  • 0 comments
  • 7 respects

Raspberry Pi and Arduino Laptop

Project tutorial by Dante Roumega

  • 17,682 views
  • 6 comments
  • 44 respects

Arduino-Based Automatic Guitar Tuner

Project tutorial by Ben Overzat

  • 3,371 views
  • 0 comments
  • 11 respects

Really Smart Box

Project tutorial by Stephen Harrison

  • 3,237 views
  • 0 comments
  • 9 respects
Add projectSign up / Login