Migrate to Markdown style guide version 0.4.0 (#77)

This project adheres to the "Arctic Ice Studio Markdown style guide" [1]
which recently published version `0.4.0` [2] that introduces some larger
changes:

- The repository was converted into a monorepo [3] and the currently
  used `remark-preset-lint-arcticicestudio` [4] npm package was
  deprecated and moved into the new, scoped
  `@arcticicestudio/remark-preset-lint` [5] package.
- Support for the shiny new remark version `13.0.0` [7] was introduced
  which is now the minimum required version for the rule preset packages.
- Several other great improvements and migrations like the adaption of
  this template repository [8] as well as the usage of the
  GitHub Flow [9] branching model and new `main` branch concept [10].

[1]: https://github.com/arcticicestudio/styleguide-markdown
[2]: https://github.com/arcticicestudio/styleguide-markdown/releases/tag/v0.4.0
[3]: svengreb/styleguide-markdown#10
[4]: https://www.npmjs.com/package/remark-preset-lint-arcticicestudio
[5]: https://www.npmjs.com/package/@arcticicestudio/remark-preset-lint
[6]: svengreb/styleguide-markdown#28
[7]: svengreb/styleguide-markdown#28
[8]: svengreb/styleguide-markdown#11
[9]: svengreb/styleguide-markdown#19
[10]: svengreb/styleguide-markdown#21

Closes GH-76

.editorconfig

@@ -1,9 +1,14 @@
 # Copyright (c) 2020-present Sven Greb <development@svengreb.de>
 # This source code is licensed under the MIT license found in the LICENSE file.
 
+# Configurations for EditorConfig.
+# See https://editorconfig.org/#file-format-details for more details.
+
 # +--------------------+
 # + Base Configuration +
 # +--------------------+
+root = true
+
 [*]
 charset = utf-8
 end_of_line = lf

.gitattributes

@@ -2,9 +2,10 @@
 # This source code is licensed under the MIT license found in the LICENSE file.
 
 # Configuration to define attributes per path.
-# See the following references for more details:
-#   - https://git-scm.com/docs/gitattributes
-#   - https://git-scm.com/book/en/v2/Customizing-Git-Git-Attributes#Keyword-Expansion
+#
+# References:
+#   1. https://git-scm.com/docs/gitattributes
+#   2. https://git-scm.com/book/en/v2/Customizing-Git-Git-Attributes#Keyword-Expansion
 
 # Automatically perform line feed (LF) normalization for files detected as text and
 # leave all files detected as binary untouched.

.github/CODEOWNERS

@@ -3,8 +3,9 @@
 
 # Configuration for the GitHub feature to automatically request reviews from the code owners
 # when a pull request changes any owned files.
-# See:
-#   1. https://help.github.com/articles/about-codeowners
+#
+# References:
+#   1. https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/about-code-owners
 #   2. https://github.com/blog/2392-introducing-code-owners
 
 # +----------------------+

.github/ISSUE_TEMPLATE.md

@@ -8,6 +8,6 @@ To keep the backlog clean and actionable, issues should be opened using [one the
 
 ### Support
 
-If you got a question or need help with any aspect of the project feel free to ask and ensure to read the [extensive project documentations](https://nordtheme.com/docs).
+If you got a question or need help with any aspect of the project feel free to ask and ensure to read the [extensive project documentations](https://github.com/svengreb/tmpl/blob/main/README.md).
 
 You can also search for already opened and related issue using the search for the [“question“](https://github.com/svengreb/tmpl/labels/type-question) issue label.

.github/ISSUE_TEMPLATE/enhancement.md

@@ -14,7 +14,7 @@ This section and the instructions in the sections below are only part of this is
 Please do your best to provide as much information as possible and use a clear and descriptive title for your enhancement suggestion to help maintainers and the community understand and reproduce the behavior, find related reports and to resolve the ticket faster.
 
 - **Ensure the enhancement has not already been reported by using the [GitHub Issues search](https://github.com/svengreb/tmpl/issues)** — check if this enhancement has already been suggested. If it has **and the issue is still open**, add your additions as comment to the existing issue instead of opening a new one. If you find a closed issue that seems to be similar to this one, include a link to the original issue in the [metadata head](#metadata-head) section of this issue.
-- **Ensure your contribution belongs to the correct [baee or specialized template repository](https://github.com/svengreb?&tab=repositories&q=tmpl).**
+- **Ensure your contribution belongs to the correct [base or specialized template repository](https://github.com/svengreb?&tab=repositories&q=tmpl).**
 - **Check if the enhancement has already been implemented** — use the [latest version](https://github.com/svengreb/tmpl/releases/latest) and [`main`](https://github.com/svengreb/tmpl/tree/main) branch to ensure that the feature or improvement has not already been added.
 
 ## Metadata Head

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,14 +1,14 @@
 <!-- Click on the "Preview" tab to render the instructions in a more readable format -->
 
-> **Please read the [contribution guidelines](https://github.com/svengreb/tmpl/blob/main/CONTRIBUTING.md) before filling out this issue template**.
+> **Please read the [contribution guidelines](https://github.com/svengreb/tmpl/blob/main/CONTRIBUTING.md) before filling out this pull request template**.
 
 ## Prerequisites
 
 This section and the instructions in the sections below are only part of this pull request template. Please ensure to **delete this whole section, all pre-filled instructions of the sections below and sections you have not filled out before submitting** to ensure a clear structure and overview.
 
 Please do your best to provide as much information as possible and use a clear and descriptive title for your enhancement suggestion or bug fix to help maintainers and the community understand and reproduce the behavior, find related pull requests and to merge it faster.
 
-- **Ensure the pull request has not already been submitted by using the [GitHub Issue search](https://github.com/svengreb/tmpl/issues)** — check if this enhancement or bug fix has already been suggested. If it has **and the pull request is still open**, add your additions as comment or [suggest a change](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request#applying-a-suggested-change) to the existing pull request instead of opening a new one. If you find a closed pull request that seems to be similar to this one, include a link to the original pull request in the [metadata head](#metadata-head) section of this new pull request.
+- **Ensure the pull request has not already been submitted by using the [GitHub Pull Request search](https://github.com/svengreb/tmpl/pulls)** — check if this enhancement or bug fix has already been suggested. If it has **and the pull request is still open**, add your additions as comment or [suggest a change](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request#applying-a-suggested-change) to the existing pull request instead of opening a new one. If you find a closed pull request that seems to be similar to this one, include a link to the original pull request in the [metadata head](#metadata-head) section of this new pull request.
 - **Ensure your contribution belongs to the correct [base or specialized template repository](https://github.com/svengreb?&tab=repositories&q=tmpl).**
 - **Ensure to adhere to the [pull request contribution guidelines](https://github.com/svengreb/tmpl/blob/main/CONTRIBUTING.md#pull-requests)**, especially the one for tests and documentations.
 - **Check if the enhancement has already been implemented or bug already fixed** — use the [latest version](https://github.com/svengreb/tmpl/releases/latest) and [`main`](https://github.com/svengreb/tmpl/tree/main) branch to ensure that the enhancement or bug fix has not already been added.

.github/workflows/ci.yml

@@ -23,10 +23,10 @@ jobs:
           echo "Workflow Actor: $GITHUB_ACTOR"
       - name: Checkout repository
         uses: actions/checkout@v2
-      - name: "Setup Node.js version 14.x"
+      - name: "Setup Node.js version 15"
         uses: actions/setup-node@v2.1.5
         with:
-          node-version: "15.13.x"
+          node-version: "15"
       - name: Install Node modules
         run: npm install
       - name: Run linters

.gitignore

@@ -1,7 +1,7 @@
 # Copyright (c) 2020-present Sven Greb <development@svengreb.de>
 # This source code is licensed under the MIT license found in the LICENSE file.
 
-# Configuration to specify paths to ignore.
+# Path match pattern to intentionally ignore untracked files and directories.
 # See https://git-scm.com/docs/gitignore for more details.
 
 # +--------------------+

.husky/pre-commit

@@ -3,10 +3,11 @@
 # Copyright (c) 2020-present Sven Greb <development@svengreb.de>
 # This source code is licensed under the MIT license found in the LICENSE file.
 
-# The configuration for husky.
+# Git "pre-commit" hook for husky.
 #
 # References:
 #   1. https://github.com/typicode/husky
+#   2. https://git-scm.com/docs/githooks#_pre_commit
 
 . "$(dirname "$0")/_/husky.sh"
 

.mailmap

@@ -1,7 +1,7 @@
 # Copyright (c) 2020-present Sven Greb <development@svengreb.de>
 # This source code is licensed under the MIT license found in the LICENSE file.
 
-# Configuration for Git mail mapping feature to coalesce together commits by the same person in the shortlog,
+# Configuration for the Git mail mapping feature to coalesce together commits by the same person in the shortlog,
 # where their name and/or email address was spelled differently or has been changed.
 # See https://git-scm.com/docs/git-shortlog#_mapping_authors for more details.
 Sven Greb <development@svengreb.de>

.npmrc

@@ -1,2 +1,19 @@
-package-lock=false
-save-exact=true
+# Copyright (c) 2020-present Sven Greb <development@svengreb.de>
+# This source code is licensed under the MIT license found in the LICENSE file.
+
+# Configurations for npm.
+# See https://docs.npmjs.com/cli/v7/configuring-npm/npmrc for more details.
+
+# Only use a lockfile for single-consumer projects, like applications, but not for multi-consumer projects like
+# libraries.
+# It helps to pin dependency versions, improves the security through integrity checksums, prevents possible errors
+# caused by updated transitive dependencies and allows to get deterministic build results, but it can hide problems in
+# multi-consumer projects when any later versions of a used dependency, or its transitive dependencies, is not
+# compatible with the own project anymore.
+# See https://github.com/svengreb/tmpl/issues/70 for more details.
+package-lock=true
+
+# Resolve to the latest minor and patch updates.
+# Enable to automatically pin dependencies to exact versions instead of resolving to latest minor and patch updates.
+# This prevents possible errors caused by updated transitive dependencies.
+save-exact=false

.prettierignore

@@ -1,7 +1,7 @@
 # Copyright (c) 2020-present Sven Greb <development@svengreb.de>
 # This source code is licensed under the MIT license found in the LICENSE file.
 
-# Configuration to specify paths to ignore.
+# Path match pattern to ignore (i.e. not reformat) certain files and folders.
 # See https://prettier.io/docs/en/ignore for more details.
 
 **/node_modules/*

.remarkignore

@@ -1,7 +1,7 @@
 # Copyright (c) 2020-present Sven Greb <development@svengreb.de>
 # This source code is licensed under the MIT license found in the LICENSE file.
 
-# Configuration to specify paths to ignore.
+# Path match pattern to ignore when searching for files.
 # See https://github.com/unifiedjs/unified-engine/blob/HEAD/doc/ignore.md for more details.
 
 # Important: Directories must have no "asterisk" wildcard character at the path end,

.remarkrc.js

@@ -4,10 +4,10 @@
  */
 
 /**
- * The configuration for remark-lint.
+ * Configurations for remark-lint.
  *
  * @see https://github.com/remarkjs/remark-lint
  */
 module.exports = {
-  plugins: ["remark-preset-lint-arcticicestudio"],
+  plugins: ["@arcticicestudio/remark-preset-lint"],
 };

CHANGELOG.md

@@ -32,8 +32,8 @@ This change also comes with updates to all documentations, including the additio
 ↠ Bumped outdated Go module dependencies and GitHub actions to their latest versions:
 
 - #67, #68, #69 (⊶ 8bff7a5d, 46a92f0a, 14a9108e) [`actions/setup-node`][gh-actions/setup-node] from [v2.1.2 to v2.1.5][gh-actions/setup-node-comp-v2.1.2_v2.1.5]
-- #74 ⇄ #75 (⊶ d827dbf5) [husky][gh-typicode/husky] — Bumped minimum version from [`v4.3.0` to `v6.0.0`][gh-typicode/husky-comp-v4.3.0_v6.0.0]. This also includes some breaking changes that require migrations. Run the official migration CLI to automatically migrate from v4 to v6: `npx husky-init && npm exec -- github:typicode/husky-4-to-6 --remove-v4-config`
-- #74 ⇄ #75 (⊶ d827dbf5) [lint-staged][gh-okonet/lint-staged] — Bumped minimum version from [`v10.5.1` to `v10.5.4`][gh-okonet/lint-staged-comp-v10.5.1_v10.5.4].
+- #74 ⇄ #75 (⊶ d827dbf5) [husky][] — Bumped minimum version from [`v4.3.0` to `v6.0.0`][gh-typicode/husky-comp-v4.3.0_v6.0.0]. This also includes some breaking changes that require migrations. Run the official migration CLI to automatically migrate from v4 to v6: `npx husky-init && npm exec -- github:typicode/husky-4-to-6 --remove-v4-config`
+- #74 ⇄ #75 (⊶ d827dbf5) [lint-staged][] — Bumped minimum version from [`v10.5.1` to `v10.5.4`][gh-okonet/lint-staged-comp-v10.5.1_v10.5.4].
 - #74 ⇄ #75 (⊶ d827dbf5) [remark-cli][gh-remarkjs/remark] — Bumped minimum version from [`v8.0.1` to `v9.0.0`][gh-remarkjs/remark-comp-v8.0.1_v9.0.0].
 
 </details>
@@ -140,8 +140,8 @@ Basically #22 was reverted, taking the changes from #23 into account, so that SV
 ↠ Bumped outdated Node.js package dependencies & GitHub Actions to their latest versions:
 
 - #54 (⊶ 41e11b94) [`actions/setup-node`][gh-actions/setup-node] from [v1 to v2.1.2][gh-actions/setup-node-comp-v1_v2.1.2] — v2 comes with speed and performance improvements by using a dedicated, built-in image cache for Node.js distributions.
-- #55 (⊶ d1e3d538) [`lint-staged`][gh-lint-staged] from [10.2.11 to 10.5.12][gh-lint-staged-comp-v10.2.11_v10.5.1]
-- #56 (⊶ 22652c51) [`husky`][gh-husky] from [4.2.5 to 4.3.0][gh-husky-comp-v4.2.5_v4.3.0]
+- #55 (⊶ d1e3d538) [`lint-staged`][lint-staged] from [10.2.11 to 10.5.12][gh-lint-staged-comp-v10.2.11_v10.5.1]
+- #56 (⊶ 22652c51) [`husky`][husky] from [4.2.5 to 4.3.0][gh-husky-comp-v4.2.5_v4.3.0]
 - #57 (⊶ 17378a12) [`prettier`][prettier] from [2.0.5 to 2.1.2][gh-prettier-comp-2.0.5_2.1.2]
 
 </details>
@@ -525,7 +525,7 @@ The `.huskyrc.js` configuration file is placed in the project root and includes
 
 <p align="center"><img src="https://user-images.githubusercontent.com/13448100/91175894-c4159400-e6e1-11ea-893d-84c1b561fe31.png" /></p>
 
-↠ Using [GitHub Actions][gh-actions] brings many advantages like a „close-to-the-source“ development pipeline. Having the code and automated pipelines/workflows in one place is worth a lot. This also comes along with the perfect and smooth integrations into GitHub platform and page itself like status reports on PRs and many more possibilities like the [customization and triggering of workflows through webhooks][gh-docs-actions-events] for almost every event that can occur in a repository/issue/PR etc.
+↠ Using [GitHub Actions][gh-docs-actions] brings many advantages like a „close-to-the-source“ development pipeline. Having the code and automated pipelines/workflows in one place is worth a lot. This also comes along with the perfect and smooth integrations into GitHub platform and page itself like status reports on PRs and many more possibilities like the [customization and triggering of workflows through webhooks][gh-docs-actions-events] for almost every event that can occur in a repository/issue/PR etc.
 
 <p align="center">
   <figure>
@@ -651,6 +651,9 @@ otherwise Markdown elements are not parsed and rendered!
 <!-- Shared -->
 
 [gh-actions/setup-node]: https://github.com/actions/setup-node
+[gh-docs-actions]: https://docs.github.com/en/actions
+[husky]: https://github.com/typicode/husky
+[lint-staged]: https://github.com/okonet/lint-staged
 [prettier]: https://prettier.io
 [shields.io]: https://shields.io
 [yarn-docs-lock]: https://yarnpkg.com/lang/en/docs/yarn-lock
@@ -663,7 +666,6 @@ otherwise Markdown elements are not parsed and rendered!
 [gh-13]: https://github.com/svengreb/tmpl/issues/13
 [gh-15]: https://github.com/svengreb/tmpl/issues/15
 [gh-17]: https://github.com/svengreb/tmpl/issues/17
-[gh-actions]: https://docs.github.com/en/actions
 [gh-blog-codeowner_intro]: https://github.blog/2017-07-06-introducing-code-owners
 [gh-blog-community_tools]: https://github.blog/2017-06-14-new-community-tools
 [gh-blog-contrib_guidelines]: https://github.blog/2012-09-17-contributing-guidelines
@@ -672,7 +674,6 @@ otherwise Markdown elements are not parsed and rendered!
 [gh-comm_profile]: https://github.com/svengreb/tmpl/community
 [gh-compare-tag-init_v0.1.0]: https://github.com/svengreb/tmpl/compare/0b0d7aee...v0.1.0
 [gh-docs-actions-events]: https://docs.github.com/en/actions/reference/events-that-trigger-workflows#webhook-events
-[gh-docs-actions]: https://docs.github.com/en/actions
 [gh-docs-coc]: https://docs.github.com/en/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project
 [gh-docs-contrib-guide]: https://docs.github.com/en/github/building-a-strong-community/setting-guidelines-for-repository-contributors
 [gh-docs-issue_pr_tmpl]: https://docs.github.com/en/github/building-a-strong-community/about-issue-and-pull-request-templates
@@ -693,9 +694,7 @@ otherwise Markdown elements are not parsed and rendered!
 [gofmt]: https://golang.org/cmd/gofmt
 [goldmark]: https://github.com/yuin/goldmard
 [husky-hooks]: https://github.com/typicode/husky/blob/master/DOCS.md#supported-hooks
-[husky]: https://github.com/typicode/husky
 [lefthook]: https://github.com/Arkweid/lefthook
-[lint-staged]: https://github.com/okonet/lint-staged
 [markdown]: https://en.wikipedia.org/wiki/Markdown
 [mit]: https://opensource.org/licenses/MIT
 [nodejs]: https://nodejs.org
@@ -721,7 +720,7 @@ otherwise Markdown elements are not parsed and rendered!
 [gh-docs-actions-wf#on_pull]: https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths
 [gh-docs-actions-wf#on_push_pull]: https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestbranchestags
 [goland]: https://www.jetbrains.com/go
-[intellij]: https://www.jetbrains.com
+[intellij]: https://www.jetbrains.com/idea
 [jetbrains-plugins]: https://plugins.jetbrains.com
 [jetbrains]: https://www.jetbrains.com
 
@@ -756,9 +755,7 @@ otherwise Markdown elements are not parsed and rendered!
 [gh-actions/setup-node-comp-v1_v2.1.2]: https://github.com/actions/setup-node/compare/v1...v2.1.2
 [gh-compare-tag-v0.6.0_v0.7.0]: https://github.com/svengreb/tmpl/compare/v0.6.0...v0.7.0
 [gh-husky-comp-v4.2.5_v4.3.0]: https://github.com/typicode/husky/compare/v4.2.5...v4.3.0
-[gh-husky]: https://github.com/typicode/husky
 [gh-lint-staged-comp-v10.2.11_v10.5.1]: https://github.com/okonet/lint-staged/compare/v10.2.11...v10.5.1
-[gh-lint-staged]: https://github.com/okonet/lint-staged
 [gh-prettier-comp-2.0.5_2.1.2]: https://github.com/prettier/prettier/compare/2.0.5...2.1.2
 
 <!-- v0.8.0 -->
@@ -782,12 +779,10 @@ otherwise Markdown elements are not parsed and rendered!
 [gh-compare-tag-v0.8.0_v0.9.0]: https://github.com/svengreb/tmpl/compare/v0.8.0...v0.9.0
 [gh-npm/cli-rel-v7.7.0]: https://github.com/npm/cli/releases/tag/v7.7.0
 [gh-okonet/lint-staged-comp-v10.5.1_v10.5.4]: https://github.com/typicode/husky/compare/v10.5.1...v10.5.4
-[gh-okonet/lint-staged]: https://github.com/okonet/lint-staged
 [gh-remarkjs/remark-comp-v8.0.1_v9.0.0]: https://github.com/typicode/husky/compare/v8.0.1...v9.0.0
 [gh-remarkjs/remark]: https://github.com/remarkjs/remark/releases
 [gh-sindresorhus/ama-479#c-310661514]: https://github.com/sindresorhus/ama/issues/479#issuecomment-310661514
 [gh-typicode/husky-comp-v4.3.0_v6.0.0]: https://github.com/typicode/husky/compare/v4.3.0...v6.0.0
-[gh-typicode/husky]: https://github.com/typicode/husky
 [gh-yarnpkg/berry]: https://github.com/yarnpkg/berry
 [node-dist-v15.13.0]: https://nodejs.org/dist/v15.13.0
 [npm-blog-v7_keep_lock]: https://blog.npmjs.org/post/621733939456933888/npm-v7-series-why-keep-package-lockjson.html