@algolia/utm-attribution

UTM Attribution (Algolia domains)

This NPM package aims to unify our capture and storage strategy towards UTMs (Urchin Tracking Module) on all Algolia domains/sub-domains (Website, Blog, Dashboard, Docs, etc.).

How to contribute

1. Clone this repository:

git clone [e-mail]:algolia/utm-attribution.git

2. Create a branch, update the code, and make a commit and a PR to develop following SEMVER versioning convention.

Releases

Once you consider that the develop branch holds enough changes to release a new version, here are the 5 steps to follow:

1. make sure you're releasing the correct version:

   • Breaking change, bump the first number (1.2.3 -> 2.0.0) - Major
   • New feature, bump the second number (1.2.3 -> 1.3.0) - Minor
   • Bug fixing, bump the third number (1.2.3 -> 1.2.4) - Patch
   • Unsure? Check SEMVER

2. run npm version [your_version]. This will automatically:

   • checkout develop
   • create a branch named with the version number
   • update the version number
   • push it to GitHub

3. have a look at the auto-generated CHANGELOG.md. Update some information manually if needed, commit and push it

4. create two PRs:

   • one to merge [your_version] into develop (this will update the package.json version)
   • the other one to merge [your_version] into main.

5. run npm run publish or yarn publish to push the new release to npm.