Contribute to the Arduino Reference

<h3 >The Arduino Language Reference Migration</h3>We replaced the <a href="https://www.arduino.cc/reference/en/">Arduino Language Reference</a> pages with an updated version hosted on <a href="https://github.com/arduino/reference-en">GitHub,</a> making it easier for anyone in the community to suggest changes and improvements.<h3 >The Arduino Glossary </h3>We have also published online the <a href="https://www.arduino.cc/glossary/en/">Arduino Glossary.</a> If you find anything that can be improved or you want to suggest a new term write us on <a href="https://github.com/arduino/glossary-content">Github</a>!<h3 >Next Steps </h3>We are planning on doing the same process with the <a href="https://www.arduino.cc/en/Reference/Libraries">Library Reference</a>. 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! <h3 >How to Contribute on GitHub</h3>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<a href="https://help.github.com/articles/editing-files-in-another-user-s-repository/"> this guide by the GitHub team </a>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, <a href="https://github.com/join">sign up on GitHub.</a>2. Go to a repository on GitHub. For instance, the<a href="https://github.com/arduino/reference-en"> Arduino Language Reference in English</a>. Select the file you want to edit by double clicking on the file tree.<figure><img src=https://projects.arduinocontent.cc/b516a3ec-ca00-4950-914f-441c5e6d3647.png /><figcaption> </figcaption></figure>3. Click on the Edit button in the upper right corner.<figure><img src=https://projects.arduinocontent.cc/67c53668-e07f-4690-a348-2ceb3923728f.png /><figcaption> </figcaption></figure>4. You are now ready to modify the file! Just type on it and preview your changes in the Preview tab.<figure><img src=https://projects.arduinocontent.cc/d9b03e0b-bb0c-47c1-bc72-6048a370dcc1.png /><figcaption> </figcaption></figure>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.<figure><img src=https://projects.arduinocontent.cc/2b7ead08-1438-4485-acaa-f01b8de4f930.png /><figcaption> </figcaption></figure>6. You will be redirected to the Comparing Changes page. Make sure all your edits are correct. When done reviewing, press 'Create Pull Request.'<figure><img src=https://projects.arduinocontent.cc/a0beb74e-9b08-47ab-8a6a-799d9486a4fd.png /><figcaption> </figcaption></figure>7. Time to create your pull request! Add any additional comments, then submit your contribution to the Arduino team for review.<figure><img src=https://projects.arduinocontent.cc/a45d1fd6-379d-4d42-81ad-6d83d4a2ba3f.png /><figcaption> </figcaption></figure>8. That's it! Your edits will be reviewed and hopefully merged into the main repository. They will be available online on the temp <a href="https://www.arduino.cc/reference/en/">Reference page</a> in a few hours. Thank you so much for your contribution! <figure><img src=https://projects.arduinocontent.cc/0bb2dec2-8a03-4e37-9c19-5325d6ad576f.png /><figcaption> </figcaption></figure>9. If you discover that a section is missing in a Reference Language page and want to add it, you can look up the <a href="https://github.com/arduino/reference-en/tree/master/AsciiDoc_sample/Reference_Terms">template pages for formatting guidelines</a> and more information on <a href="https://github.com/arduino/reference-en/tree/master/AsciiDoc_sample/AsciiDoc_Dictionary">ASCIIDOC</a>. There are two kinds of template pages: <ul ><li >A <a href="https://github.com/arduino/reference-en/blob/master/AsciiDoc_sample/Reference_Terms/AsciiDoc_Template-Single_Entity.adoc">single-entity page</a>, like <a href="https://www.arduino.cc/en/Reference/Loop">Loop </a>where you will find all the information on a specific Reference term. </li></ul><ul ><li >A <a href="https://github.com/arduino/reference-en/blob/master/AsciiDoc_sample/Reference_Terms/AsciiDoc_Template-Parent_Of_Entities.adoc">parent-of-entity page,</a> like <a href="https://www.arduino.cc/en/Reference/MouseKeyboard">Mouse &amp; Keyboard </a>for groups of functions.</li></ul><h3 >Multi-Language Support</h3>Migrating all the Reference on GitHub will finally allow us to support multiple languages! Thanks to <a href="https://github.com/tanoueakira">Akira Tanoue,</a> we already have quite a <a href="https://cdn.arduino.cc/reference/jp/">few pages in Japanese</a>, which are available <a href="https://github.com/arduino/reference-jp">here if you want to contribute</a> too.Other languages you can begin contributing to (by translating the English versions) are: <a href="https://github.com/arduino/reference-es">Spanish</a>, <a href="https://github.com/arduino/reference-it">Italian</a>, <a href="https://github.com/arduino/reference-de">German</a>, <a href="https://github.com/arduino/reference-fr">French</a>... and <a href="https://github.com/arduino/reference-pt">Portuguese</a> thanks to <a href="https://github.com/robsoncouto">Robson Couto.</a>

Contribute to the Arduino Reference

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