[20] Fix NextJS example "showExperiments" query string and update contributing guide (#21)

Author: TomStrepsil

.github/pull_request_template.md

@@ -1,6 +1,6 @@
 # Issue
 
-[_ISSUE_ID_](https://github.com/ASOS/web-toggle-point/issues/_ISSUE_ID_)
+resolves #_ISSUE_ID_
 
 ## Details
 

docs/CHANGELOG.md

@@ -14,11 +14,31 @@ N.B. See changelogs for individual packages, where most change will occur:
 
 This log covers the [monorepo](https://en.wikipedia.org/wiki/Monorepo).
 
+## [0.10.5] - 2025-03-06
+
+### Fixed
+
+- updated the `CONTRIBUTING.md`:
+  - clarification regarding changes needing to be committed for the `danger:local` script to be effective
+  - clarification regarding write access or forking being needed to open a pull request
+
+### Changed
+
+- updated main `README.md`:
+  - linked to `CONTRIBUTING.md`
+  - added link to repo discussions, alongside the issues
+  - clarified the convention-based approach to advice
+- updated `pull_request_template.md` to ensure "resolves #issue" is prompted, to make sure linked issues are closed automatically with PR merges
+
+### Added
+
+ - a `danger:local:staged` command to augment the above danger fix
+
 ## [0.10.4] - 2025-03-06
 
 ### Fixed
 
-- Ensured that the registry is explicitly set, to ensure that [`@actions/setup-node`](https://github.com/actions/setup-node) honours the `NODE_AUTH_TOKEN`
+- ensured that the registry is explicitly set, to ensure that [`@actions/setup-node`](https://github.com/actions/setup-node) honours the `NODE_AUTH_TOKEN`
 
 ## [0.10.3] - 2025-02-27
 

docs/CONTRIBUTING.md

@@ -16,6 +16,9 @@ On this project we follow mainline development (or trunk based development), and
 
 Therefore you need to branch / fork from `main` and merge into `main`.
 
+> [!NOTE]
+> To contribute a pull request, [you will need to fork the repository](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork) or be given [write access](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request), so get in touch to discuss the latter!
+
 ### Coding style
 
 Generally try to match the style and conventions of the code around your changes. Ultimately we want code that is clear, concise, consistent and easy to read.
@@ -35,6 +38,12 @@ npm run test:unit
 npm run test:automation
 npm run danger:local
 ```
+> [!NOTE]
+> N.B. The `danger:local` script requires staged changes to be committed, otherwise you will receive the message:
+>
+> `No git changes detected between head and main`
+>
+> If you'd like to check just staged commits, you can instead run `npm run danger:local:staged`
 
 ## Opening a PR
 

docs/README.md

@@ -31,11 +31,11 @@ A library providing a means to toggle or branch web application code.
 
 ### 🐬 Purpose
 
-This library provides a means to toggle or branch application code. 
+This library provides a means to toggle or branch application code at runtime, whilst mitigating the carrying costs of doing so.
 
 It aims to enable low friction feature toggling [aspect/advice](https://en.wikipedia.org/wiki/Advice_(programming))[^1] in a codebase.
 
-It suggests a convention-based approach to storing variant code, aiming to mitigate [boilerplate](https://en.wikipedia.org/wiki/Boilerplate_code) whilst developing new features, and reduce the friction of accepting or rejecting toggled variations, when appropriate.
+It suggests a convention-based approach to storing variant code, aiming to mitigate [boilerplate](https://en.wikipedia.org/wiki/Boilerplate_code) whilst developing new features, and reduce the friction of accepting or rejecting toggled variations, if and when the time arises.
 
 Originally developed for experiment toggles / flags, it acts only as a means to implement a toggle point, separating any toggle router concern, so is agnostic of the type of toggle or flag.
 
@@ -84,7 +84,7 @@ Please see separate [examples documentation](../examples/README.md).
 
 ### 🔜 Future Plans
 
-Please see [issues](https://github.com/ASOS/web-toggle-point/issues) and please consider contributing!
+Please see [discussions](https://github.com/ASOS/web-toggle-point/discussions) and [issues](https://github.com/ASOS/web-toggle-point/issues), and please consider [contributing](./CONTRIBUTING.md)!
 
 ### 🔗 Links
 

examples/express/README.md

@@ -4,8 +4,8 @@ Some example applications based on an [express](https://expressjs.com/) router
 
 1. [animals](./src/routes/animals/README.md)
 
-   This is a basic example using the [`webpack`](../packages/webpack/docs/README.md) package.
+   This is a basic example using the [`webpack`](../../packages/webpack/docs/README.md) package.
 
 2. [config](./src/routes/config/README.md)
 
-   This example shows the use of the [`react-pointcuts`](../packages/react-pointcuts/docs/README.md), [`features`](../packages/features/docs/README.md), [`ssr`](../packages/ssr/docs/README.md) and [`webpack`](../packages/webpack/docs/README.md) packages.
+   This example shows the use of the [`react-pointcuts`](../../packages/react-pointcuts/docs/README.md), [`features`](../../packages/features/docs/README.md), [`ssr`](../../packages/ssr/docs/README.md) and [`webpack`](../../packages/webpack/docs/README.md) packages.

examples/express/docs/CHANGELOG.md

@@ -5,6 +5,13 @@ 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/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.4] - 2024-02-07
+
+### Fixed
+
+- corrected some links to packages from the examples readme
+- removed orphan `index.js` in the animals example, this has been supplanted by `router.js`
+
 ## [0.2.3] - 2024-12-24
 
 ### Changed

examples/express/package.json

@@ -1,6 +1,6 @@
 {
   "name": "web-toggle-point-express-example",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "type": "module",
   "engines": {
     "node": ">=20.6.0"

examples/express/src/routes/animals/index.js

@@ -5,6 +5,12 @@ 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/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.3] - 2025-02-07
+
+### Fixed
+
+- fixed a regression in the ability to use `?showExperiments` query in the experiments fixtures, regressed in version `0.2.0`.
+
 ## [0.2.2] - 2024-12-24
 
 ### Fixed

examples/next/docs/CHANGELOG.md

@@ -1,6 +1,6 @@
 {
   "name": "web-toggle-point-next-example",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "private": true,
   "type": "module",
   "scripts": {