docs: add release instructions

Author: woutslabbinck

.versionrc.json

@@ -0,0 +1,15 @@
+{
+  "types": [
+    { "type": "feat", "section": "Features" },
+    { "type": "fix", "section": "Fixes" },
+    { "type": "chore", "section": "Chores" },
+    { "type": "chore(deps)", "section": "Dependency updates" },
+    { "type": "docs", "section": "Documentation" },
+    { "type": "style", "section": "Styling" },
+    { "type": "refactor", "section": "Refactors" },
+    { "type": "perf", "section": "Performance" },
+    { "type": "test", "section": "Testing" }
+  ],
+  "header": "<!-- markdownlint-disable MD013 -->\n# Changelog\n\nAll notable changes to this project will be documented in this file.",
+  "releaseCommitMessageFormat": "chore(release): Release version {{currentTag}} of the npm package"
+}

CHANGELOG.md

@@ -1 +1,23 @@
-TODO
+# ODRL Evaluator release notes
+
+## [0.4.0](https://github.com/SolidLabResearch/ODRL-Evaluator/compare/v0.3.0...v0.4.0)
+
+
+### Features
+
+* create dedicated Atomizer class and add roadmap for atomization feature ([5f5bad6](https://github.com/SolidLabResearch/ODRL-Evaluator/commit/5f5bad6bae8863d6a05b425a9af82c8a4e0d0484))
+* create ODRL Evaluator that natively deals with Compact Rules + test ([05cfa15](https://github.com/SolidLabResearch/ODRL-Evaluator/commit/05cfa15b2f9bebeb44ec0c5a984016c24b253890))
+* introduce tests ([46729fd](https://github.com/SolidLabResearch/ODRL-Evaluator/commit/46729fd837687b6a9d383f5a42ab44b55b2e8570))
+* test2 now contains full algorithm ([bba88da](https://github.com/SolidLabResearch/ODRL-Evaluator/commit/bba88da8630a4b38dbaae0203454cfe553b3b348))
+
+
+### Fixes
+
+* make sure tests run online by relying on eyeJs ([1fdd36c](https://github.com/SolidLabResearch/ODRL-Evaluator/commit/1fdd36c8346c7f201914465dc73f7f6c0a1633cb))
+
+
+### Documentation
+
+* add citation instructions to ODRL Evaluator ([b8ef6bd](https://github.com/SolidLabResearch/ODRL-Evaluator/commit/b8ef6bd6680453e490efe1db439d891afb0792e1))
+* add release notes and bump version to 0.4.0 ([61478db](https://github.com/SolidLabResearch/ODRL-Evaluator/commit/61478db33243712b5a8d0091bc142b4b8a7199cc))
+* update Release notes and Atomization documentation ([867c08f](https://github.com/SolidLabResearch/ODRL-Evaluator/commit/867c08fe1d28ed32d84c9adec2a5fd571b522b79))

documentation/release.md

@@ -0,0 +1,15 @@
+# Releasing a new version
+
+This is only relevant if you are a developer with push access responsible for doing a new release.
+
+Steps to follow:
+- Verify that the `RELEASE_NOTES.md` are correct.
+- Create release notes and tags: `npx commit-and-tag-version -r major/minor/patch`
+  - Updates the package.json, and generates the new entries in CHANGELOG.md. Commits with chore(release): Release version vx.y.z of the npm package
+  - Optionally run `npx commit-and-tag-version -r major/minor/patch --dry-run` to preview the commands that will be run and the changes to CHANGELOG.md.
+- Do a GitHub release
+- npm release: `npm run release`
+- potentially upgrade dependent repositories
+  - ODRL Test Suite at https://github.com/SolidLabResearch/ODRL-Test-Suite
+  - FORCE demo at https://github.com/woutslabbinck/ODRL-Evaluator-Demo
+  - User-Access Server at https://github.com/SolidLabResearch/user-managed-access