Library Maintainers Guide

Library Maintainers Guide & Notes.

New version release checklist

1. git checkout master; git pull Make sure your master branch is up-to-date
2. git branch -b vXX.YY.ZZ Where vXX.YY.ZZ is the new version string. e.g. v2.3.2
3. Change the library version in the code:
   1. Update _IRREMOTEESP8266_VERSION_ in src/IRremoteESP8266.h to the new version number.
   2. Update version in library.json & version= in library.properties accordingly.
   3. All three must be the same.
4. Update the version information in the documentation:
   1. Update "Now Available" section in README.md.
   2. Update ReleaseNotes.md and add a new section for the new release.
      • git log should show you the change history.
      • Update the date to today's date for the new release.
5. Run tools/mkkeywords > keywords.txt from the top directory. (Requires a Linux machine etc)
6. git commit -a and create an appropriate entry. e.g. "v2.3.2 release"
7. git push --set-upstream origin vXX.YY.ZZ
8. Wait for the Travis build to complete successfully.
9. Create a Pull Request to the 'master' branch:
   • Set appropriate reviewers as needed.
   • Copy in the new section of the ReleaseNotes.md as the PR comment.
10. Wait for:
    1. Approval (or not, all the substantial commits should have already been done)
    2. Travis to pass
    3. Only then, merge to master.
11. Go to the Releases tab in github.
    1. Click "Draft a new release".
    2. Tag Version: vXX.YY.ZZ
    3. Target: Master
    4. Release title: IRremoteESP8266
    5. Notes: Cut & paste from the ReleaseNotes.md update.
    6. Make sure the pre-release checkbox is un-checked.
    7. Click the Preview tab and check it looks okay.
    8. Publish Release
12. The new release is now live. Arduino IDE's Library Manager should pick up the new version within 24 hours.
13. Update any reported bugs that were fixed by changes that happened between this new version and the now previous one.
14. Relax. Grab a cold beverage. It's all done.