changelog header

Author: billyc

docs/CHANGELOG-header.md

@@ -1,8 +1,12 @@
 ---
 id: changelog
-title: Change log
+title: SimWrapper Change Log
 ---
 
-Welcome to SimWrapper! All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+Welcome to SimWrapper! All notable changes to this project are documented in this file.
 
-The full commit history is on GitHub at <https://github.com/simwrapper/simwrapper>.
+The list of changes is generated automatically based on the commit messages themselves. If the first line of a commit begins with either `fix:` or `feat:` then the commit will be registered as a fix or a feature in the list below. Links to the commits and GitHub Issues are also autogenerated based on the commit messages.
+
+- See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+- The SimWrapper code repository containing the full commit history is on GitHub at <https://github.com/simwrapper/simwrapper>.

docs/CHANGELOG.md

@@ -1,11 +1,15 @@
 ---
 id: changelog
-title: Change log
+title: SimWrapper Change Log
 ---
 
-Welcome to SimWrapper! All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+Welcome to SimWrapper! All notable changes to this project are documented in this file.
 
-The full commit history is on GitHub at <https://github.com/simwrapper/simwrapper>.
+The list of changes is generated automatically based on the commit messages themselves. If the first line of a commit begins with either `fix:` or `feat:` then the commit will be registered as a fix or a feature in the list below. Links to the commits and GitHub Issues are also autogenerated based on the commit messages.
+
+- See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+- The SimWrapper code repository containing the full commit history is on GitHub at <https://github.com/simwrapper/simwrapper>.
 # Changelog
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.