changelog management by changie

Author: TheSpyder

.changes/header.tpl.md

@@ -0,0 +1,6 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html),
+and is generated by [Changie](https://github.com/miniscruff/changie).

.changes/unreleased/.gitkeep

@@ -0,0 +1,5 @@
+kind: Changed
+body: 'BREAKING: Record types are now used where possible. Requires ReScript 10.'
+time: 2023-12-10T06:31:31.479826+11:00
+custom:
+  Github Issue: "12"

.changes/unreleased/Changed-20231210-063131.yaml

@@ -0,0 +1,32 @@
+changesDir: .changes
+unreleasedDir: unreleased
+headerPath: header.tpl.md
+changelogPath: CHANGELOG.md
+versionExt: md
+versionFormat: '## {{.Version}} - {{.Time.Format "2006-01-02"}}'
+kindFormat: "### {{.Kind}}"
+changeFormat: "* [#{{.Custom.Issue}}](https://github.com/miniscruff/changie/issues/{{.Custom.Issue}}) {{.Body}}"
+kinds:
+  - label: Added
+    auto: minor
+  - label: Changed
+    auto: major
+  - label: Deprecated
+    auto: minor
+  - label: Removed
+    auto: major
+  - label: Fixed
+    auto: patch
+newlines:
+  afterChangelogHeader: 1
+  beforeChangelogVersion: 1
+  endOfVersion: 1
+envPrefix: CHANGIE_
+custom:
+  - key: Github Issue
+    type: int
+    minInt: 1
+replacements:
+  - path: package.json
+    find: '  "version": ".*",'
+    replace: '  "version": "{{.VersionNoPrefix}}",'

.changie.yaml

@@ -0,0 +1,9 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html),
+and is generated by [Changie](https://github.com/miniscruff/changie).
+
+
+No releases yet, this file will be updated when generating your first release.

CHANGELOG.md

@@ -9,11 +9,15 @@ Node.js bindings for ReScript
 ```shell
 npm install rescript-nodejs
 ```
+
 or
+
 ```shell
 yarn add rescript-nodejs
 ```
+
 Then add rescript-nodejs to `bsconfig.json`:
+
 ```
   "bs-dependencies": [
     "rescript-nodejs"
@@ -59,6 +63,7 @@ We welcome and encourage anyone to contribute! In order to minimize confusion an
 - If you want to request a feature/improvement, it's best to create an issue first and start a discussion. Don't spend a lot of valuable time and energy creating a pull request when it might not fit in with the project goals. Your PR may still be merged if it isn't based on an issue but expect to have a discussion first.
 - If you notice gaps in the documentation and want to help fill them in, feel free to go straight to PR. Or create an issue and provide a draft of the docs you want to add.
 - If you have concerns about implementation style or design decisions (e.g. type soundness, complexity, ergonomics, edge cases, etc.), please submit an issue voicing your concerns. Critique from the community is welcome. This library is only useful so long as it works for everyone!
+- A changelog has finally been added, managed by [changie](https://changie.dev). Please use this tool (available via `yarn changie new`) to add changelog entries.
 
 ## License and Credits
 

README.md

@@ -27,6 +27,7 @@
   "license": "MIT",
   "devDependencies": {
     "@dusty-phillips/rescript-zora": "^4.0.0",
+    "changie": "^1.16.1",
     "onchange": "^7.1.0",
     "pta": "^1.2.0",
     "rescript": "^11.0.0-beta.3",

package.json

@@ -71,6 +71,11 @@ braces@^3.0.1, braces@~3.0.2:
   dependencies:
     fill-range "^7.0.1"
 
+changie@^1.16.1:
+  version "1.16.1"
+  resolved "https://registry.yarnpkg.com/changie/-/changie-1.16.1.tgz#9a846f4303f569ed695dcbc9afa60a47465f0c97"
+  integrity sha512-oQp1ic8S8adpDHuqEQYdd9aHRayf/bXlDAlvfZ7U9IxeKmBXOB2QMhrpeY52n64Tzn7vXtlxCcYUwJMfpnwqDQ==
+
 chokidar@^3.3.1:
   version "3.5.2"
   resolved "https://registry.yarnpkg.com/chokidar/-/chokidar-3.5.2.tgz#dba3976fcadb016f66fd365021d91600d01c1e75"