How to release

How to release a new version of AlaSQL

AlaSQL uses git flow to manage development and Semantic Versioning to manage versioning.

In practice the result is that the master branch us never updated without updating the version number. That includes changes like minor corrections to documentation files such as README.md.

The following is a checklist for the team to remember the steps. Please update where you see a better way...

0. Make sure you have the last version of both master and develop git checkout develop && git pull && git checkout master && git pull

1. Pick the correct version number: Given a version number MAJOR.MINOR.PATCH, increment the: MAJOR version when you make incompatible API changes, MINOR version when you add functionality in a backwards-compatible manner. PATCH version when you make backwards-compatible bug fixes.

2. Create and switch to a new release branch git flow release start x.y.z (in source tree click "git flow" at the top right). Name it exactly as the new version number (for example "0.2.0").

3. Copy al content from https://github.com/agershun/alasql/wiki/readme into README.md

4. Update CHANGELOG.md with some words to what has changed. Select a city name the flavor of the day as part of the title. You can see the commits and the roadmap for inspiration to what to write

5. Create a draft of the release on github. Same description as CHANGELOG.md and with release title as "CITYNAME" (LAST_RELEASE - TODAY) for example "Athens" (02.06.2015 - 13.07.2015)

6. Change version number in src/05start.js, src/10alasql.js

7. Change version number in package.json

8. Change version number in bower.json Todo: describe how

9. Change version number for Meteor meteor/10alasql.js

10. Run gulp``, change a line in any js file in src and wait until uglyfy is done - close it. Todo: automate npm build script - or/and make better gulp file

11. Verify that npm test does not give any erros

12. Todo: describe how to locally test node_module works

13. push package to npm npm publish

14. push package to athmospherejs (Meteor) cd meteor && meteor publish && cd ..

15. Finish release git flow release finish x.y.z (for source tree just clicking "git-flow" at the top right corner)

16. Push develop to github git checkout develop && git push

17. Push master and tags to github git checkout master && git push && git push --tags

18. Finish your draft of the release on github. You should be able to find it in the dropdown in "Tag version" - and select master as branch.

---

Todo:

• implement https://www.npmjs.com/package/npm-check as part of the release check