feat(workflow): set up standard-version and update docs (#118)

* Set up and configure standard-version (no commit linting for now)
* Implement release script
* Generate initial changelog
* Update releasing and contributing docs

Author: Carlo Bernardini

CHANGELOG.md

@@ -0,0 +1,112 @@
+## [1.2.1](https://github.com/textkernel/oneui/compare/1.2.0...1.2.1) (2019-06-11)
+
+
+### Bug Fixes
+
+* **footer:** add styling to links ([#119](https://github.com/textkernel/oneui/issues/119)) ([3f0e8ad](https://github.com/textkernel/oneui/commit/3f0e8ad))
+* destruct props that should not be applied as html attributes ([#117](https://github.com/textkernel/oneui/issues/117)) ([bff61c3](https://github.com/textkernel/oneui/commit/bff61c3))
+
+
+
+# [1.2.0](https://github.com/textkernel/oneui/compare/1.1.0...1.2.0) (2019-06-06)
+
+
+### Bug Fixes
+
+* design adjustments ([#109](https://github.com/textkernel/oneui/issues/109)) ([f70fbbd](https://github.com/textkernel/oneui/commit/f70fbbd))
+* styling for buttongroup with single button ([#111](https://github.com/textkernel/oneui/issues/111)) ([16e0d9c](https://github.com/textkernel/oneui/commit/16e0d9c))
+* update default footer copyright ([#113](https://github.com/textkernel/oneui/issues/113)) ([a744bfa](https://github.com/textkernel/oneui/commit/a744bfa))
+
+
+### Features
+
+* add textkernel full logo ([#110](https://github.com/textkernel/oneui/issues/110)) ([a0c856d](https://github.com/textkernel/oneui/commit/a0c856d))
+
+
+
+# [1.1.0](https://github.com/textkernel/oneui/compare/1.0.0...1.1.0) (2019-05-21)
+
+
+### Bug Fixes
+
+* **button:** fix height issues with anchor-buttons in safari ([#106](https://github.com/textkernel/oneui/issues/106)) ([cd9a281](https://github.com/textkernel/oneui/commit/cd9a281))
+* **storybook:** initialize oneui before loading stories ([#107](https://github.com/textkernel/oneui/issues/107)) ([cc2fa8d](https://github.com/textkernel/oneui/commit/cc2fa8d))
+* dont use relative paths for importing bem package ([#104](https://github.com/textkernel/oneui/issues/104)) ([87061b2](https://github.com/textkernel/oneui/commit/87061b2))
+* **storybook:** reinstate loadingspinner label knob ([5019185](https://github.com/textkernel/oneui/commit/5019185))
+
+
+### Features
+
+* chip component ([#105](https://github.com/textkernel/oneui/issues/105)) ([b07eb08](https://github.com/textkernel/oneui/commit/b07eb08))
+
+
+
+# [1.0.0](https://github.com/textkernel/oneui/compare/0.7.0...1.0.0) (2019-05-13)
+
+
+### Bug Fixes
+
+* **a11y:** accessibility improvements ([#98](https://github.com/textkernel/oneui/issues/98)) ([eaa68d7](https://github.com/textkernel/oneui/commit/eaa68d7))
+* remove useCallback hook from pagination ([#100](https://github.com/textkernel/oneui/issues/100)) ([25e6188](https://github.com/textkernel/oneui/commit/25e6188))
+
+
+
+# [0.7.0](https://github.com/textkernel/oneui/compare/0.6.1...0.7.0) (2019-05-10)
+
+
+### Features
+
+* **component:** pagination components ([#83](https://github.com/textkernel/oneui/issues/83)) ([3081ddf](https://github.com/textkernel/oneui/commit/3081ddf))
+* forward refs in form components ([#85](https://github.com/textkernel/oneui/issues/85)) ([8df551a](https://github.com/textkernel/oneui/commit/8df551a))
+
+
+### BREAKING CHANGES
+
+* Ref forwarding may introduce observably different behavior
+
+
+
+## [0.6.1](https://github.com/textkernel/oneui/compare/0.6.0...0.6.1) (2019-05-07)
+
+
+
+# [0.6.0](https://github.com/textkernel/oneui/compare/0.5.0...0.6.0) (2019-05-01)
+
+
+### Bug Fixes
+
+* **icon:** inherit color by default ([#93](https://github.com/textkernel/oneui/issues/93)) ([2ea25b5](https://github.com/textkernel/oneui/commit/2ea25b5))
+* **storybook:** reinstate missing knobs for loadingspinner ([#91](https://github.com/textkernel/oneui/issues/91)) ([b9d029b](https://github.com/textkernel/oneui/commit/b9d029b))
+
+
+
+# [0.5.0](https://github.com/textkernel/oneui/compare/0.4.0...0.5.0) (2019-04-24)
+
+
+### Bug Fixes
+
+* **button:** do not apply context as element attribute ([#86](https://github.com/textkernel/oneui/issues/86)) ([73d3dc9](https://github.com/textkernel/oneui/commit/73d3dc9))
+
+
+### Features
+
+* **theming:** oneui themeloader ([#63](https://github.com/textkernel/oneui/issues/63)) ([ff8d34c](https://github.com/textkernel/oneui/commit/ff8d34c))
+
+
+
+# [0.4.0](https://github.com/textkernel/oneui/compare/0.3.1...0.4.0) (2019-04-18)
+
+
+
+## [0.3.1](https://github.com/textkernel/oneui/compare/0.3.0...0.3.1) (2019-03-27)
+
+
+
+# [0.3.0](https://github.com/textkernel/oneui/compare/0.2.1...0.3.0) (2019-03-22)
+
+
+
+## [0.2.1](https://github.com/textkernel/oneui/compare/0.1.0...0.2.1) (2019-02-20)
+
+
+

CONTRIBUTING.md

@@ -82,5 +82,36 @@ Each implementation should be thoroughly covered with tests. DOM structure can i
 3. Test additional interactivity / behaviour with explicit assertions
 4. Strive for 100% code coverage
 
+## Committing and Merging
+
+### Commit Messages
+OneUI's [release procedure](RELEASING.md) and [changelog](CHANGELOG.md) automation heavily relies on commit messages. Commit messages should follow the [Conventional Commit](https://www.conventionalcommits.org/en/) specifications. This is critical for the release script to determine a correct new version number. An updated changelog is generated automatically on the basis of commit messages. The commit message structure should be as follows:
+
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer]
+```
+
+Commit types include:
+* `feat`: A new feature (equivalent to `MINOR`)
+* `fix`: A bug fix (equivalent to `PATCH`)
+* `docs`: Changes to documentation
+* `test`: Changes to tests
+* `chore`: Other changes that dont affect source files, tests or documentation
+* `revert`: Reverted previous commit
+* `style`: Code style change (indentation, semicolons, ...)
+* `perf`: Performance enhancements
+* `refactor`: Code refactoring without changes to public API
+
+Use imperative, present tense in your commit description ("change", not "changed" or "changes") without uppercases or period (.) at the end.
+
+**Breaking changes** should be explicitly marked (with uppercase) in the message footer, e.g. `BREAKING CHANGE: <note>`. This will result in a new `MAJOR` package version.
+
+### Merging
+When merging a branch, squash its commits for the changelog to be nice and tidy. Each pull request / squashed commit should eventually equal one fix / feature / change in docs or tests.
+
 ## Releasing
 The procedure for making a new release is [described here](RELEASING.md).

RELEASING.md

@@ -16,39 +16,13 @@ Version numbers should not be prefixed (e.g. 1.2.3, **not** v1.2.3).
 
 ## Release Procedure
 
-1. Make sure the local `master` branch is checked out and up to date. It should contain all the latest commits that should be included with the release.
-2. Determine the new version number on the basis of [semver specifications](https://semver.org).
-3. Update the version number in metadata files (package[-lock].json), replacing `x.x.x` with actual version number:
+To make a new release, simply run **`npm run release`**.
 
-```bash
-(master) $ npm --no-git-tag-version version x.x.x
-(master) $ git add -u .
-(master) $ git commit -m "bump version number"
-```
-
-4. Create a new annotated Git tag, replacing `x.x.x` with actual version number:
-
-```bash
-(master) $ git tag -a x.x.x
-```
-
-5. In the tag message, list all significant changes that come with the new release. To list all commits since last tag, run:
-
-```bash
-(master) $ git log <lasttag>..HEAD
-```
-
-6. Push new tag to remote, replacing `x.x.x` with actual version number:
-
-```bash
-(master) $ git push origin master x.x.x
-```
-
-7. Publish new package version to [NPM](https://npmjs.com/package/@textkernel/oneui):
-
-```bash
-(master) $ npm publish --access=public
-```
+The release script will...
+1. ...auto determine a new version number on the basis of commit messages since last tag.
+2. ...update the version number in metadata files (package[-lock].json).
+3. ...generate an updated [CHANGELOG.md](CHANGELOG.md) on the basis of commit messages since last tag.
+4. ...push a new tag and publish a new package to [npm](https://npmjs.com/package/@textkernel/oneui).
 
 ## Storybook