Release v1.0.5: align docs with GitHub SerialNumberBundle, demo ports, CHANGELOG

HecFranco · HecFranco · commit fb8252cfe356 · 2026-03-30T07:34:53.000+02:00
diff --git a/.github/ISSUE_TEMPLATE/---bug-report.md b/.github/ISSUE_TEMPLATE/---bug-report.md
@@ -8,7 +8,7 @@ assignees: ''
 ---
 
 <!--
-- Please do not report an issue for a version of `serial-number-bundle` that is no longer supported. Currently supported versions are listed here: https://github.com/nowo-tech/SerialNumberBundle#version-information
+- Please do not report an issue for a version of `serial-number-bundle` that is no longer supported. See [Version policy](https://github.com/nowo-tech/SerialNumberBundle#version-policy) and [Supported versions](https://github.com/nowo-tech/SerialNumberBundle/security/policy#supported-versions) in the repository.
 - Please fill in this template according to your issue.
 - Please keep the table shown below at the top of your issue.
 - You can retrieve `serial-number-bundle` version by running `composer info | grep "serial-number-bundle"`.
diff --git a/README.md b/README.md
@@ -6,7 +6,7 @@
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![PHP](https://img.shields.io/badge/PHP-8.1%2B-777BB4?logo=php)](https://php.net)
 [![Symfony](https://img.shields.io/badge/Symfony-6%20%7C%207%20%7C%208-000000?logo=symfony)](https://symfony.com)
-[![GitHub stars](https://img.shields.io/github/stars/nowo-tech/serial-number-bundle.svg?style=social&label=Star)](https://github.com/nowo-tech/SerialNumberBundle) [![Coverage](https://img.shields.io/badge/Coverage-100%25-brightgreen)](#tests-and-coverage)
+[![GitHub stars](https://img.shields.io/github/stars/nowo-tech/SerialNumberBundle.svg?style=social&label=Star)](https://github.com/nowo-tech/SerialNumberBundle) [![Coverage](https://img.shields.io/badge/Coverage-100%25-brightgreen)](#tests-and-coverage)
 
 > ⭐ **Found this useful?** Install from Packagist and give it a star on GitHub.
 
@@ -70,6 +70,12 @@ $serial = $this->serialNumberGenerator->generate(
 - Tests: PHPUnit (PHP)
 - PHP: 100%
 
+## Version policy
+
+The Composer package name is [`nowo-tech/serial-number-bundle`](https://packagist.org/packages/nowo-tech/serial-number-bundle). Source code and issues are in the GitHub repository [`nowo-tech/SerialNumberBundle`](https://github.com/nowo-tech/SerialNumberBundle).
+
+We follow [Semantic Versioning](https://semver.org/). See [Changelog](docs/CHANGELOG.md) for release notes. Security support by major version is described in the [Security policy](.github/SECURITY.md#supported-versions).
+
 ## License
 
 MIT. See [LICENSE](LICENSE).
diff --git a/composer.json b/composer.json
@@ -13,12 +13,12 @@
         "mask",
         "pattern"
     ],
-    "homepage": "https://github.com/nowo-tech/serial-number-bundle",
+    "homepage": "https://github.com/nowo-tech/SerialNumberBundle",
     "support": {
-        "issues": "https://github.com/nowo-tech/serial-number-bundle/issues",
-        "source": "https://github.com/nowo-tech/serial-number-bundle",
-        "docs": "https://github.com/nowo-tech/serial-number-bundle/tree/main/docs",
-        "changelog": "https://github.com/nowo-tech/serial-number-bundle/blob/main/docs/CHANGELOG.md"
+        "issues": "https://github.com/nowo-tech/SerialNumberBundle/issues",
+        "source": "https://github.com/nowo-tech/SerialNumberBundle",
+        "docs": "https://github.com/nowo-tech/SerialNumberBundle/tree/main/docs",
+        "changelog": "https://github.com/nowo-tech/SerialNumberBundle/blob/main/docs/CHANGELOG.md"
     },
     "authors": [
         {
diff --git a/demo/README.md b/demo/README.md
@@ -1,13 +1,13 @@
 # Serial Number Bundle – Demos
 
-Demos for [nowo-tech/serial-number-bundle](https://github.com/nowo-tech/serial-number-bundle) on Symfony 7 and 8.
+Demos for Composer package [nowo-tech/serial-number-bundle](https://packagist.org/packages/nowo-tech/serial-number-bundle) ([source on GitHub](https://github.com/nowo-tech/SerialNumberBundle)) on Symfony 7 and 8.
 
 ## Demos
 
-| Demo        | Symfony | Port (default) |
-|------------|---------|----------------|
-| symfony7   | 7.0     | 8001           |
-| symfony8   | 8.0     | 8001           |
+| Demo        | Symfony | Port (default in `.env.example`) |
+|------------|---------|----------------------------------|
+| symfony7   | 7.0     | 8007                             |
+| symfony8   | 8.0     | 8008                             |
 
 ## Quick start (from bundle root)
 
@@ -19,7 +19,7 @@ make -C demo up-symfony8
 make -C demo up-symfony7
 ```
 
-Then open http://localhost:8001 (or the `PORT` in the demo’s `.env`).
+Then open `http://localhost:<PORT>` (e.g. http://localhost:8008 for Symfony 8, or the `PORT` in the demo’s `.env`).
 
 ## Path repository
 
diff --git a/demo/symfony7/README.md b/demo/symfony7/README.md
@@ -1,6 +1,6 @@
 # Serial Number Bundle - Symfony 7 Demo
 
-Demo application for [nowo-tech/serial-number-bundle](https://github.com/nowo-tech/serial-number-bundle) on Symfony 7.0.
+Demo application for [`nowo-tech/serial-number-bundle`](https://packagist.org/packages/nowo-tech/serial-number-bundle) ([GitHub](https://github.com/nowo-tech/SerialNumberBundle)) on Symfony 7.0.
 
 ## Quick start
 
diff --git a/demo/symfony7/composer.lock b/demo/symfony7/composer.lock
diff --git a/demo/symfony8/README.md b/demo/symfony8/README.md
@@ -1,6 +1,6 @@
 # Serial Number Bundle - Symfony 8 Demo
 
-Demo application for [nowo-tech/serial-number-bundle](https://github.com/nowo-tech/serial-number-bundle) on Symfony 8.0.
+Demo application for [`nowo-tech/serial-number-bundle`](https://packagist.org/packages/nowo-tech/serial-number-bundle) ([GitHub](https://github.com/nowo-tech/SerialNumberBundle)) on Symfony 8.0.
 
 ## Quick start
 
diff --git a/demo/symfony8/composer.lock b/demo/symfony8/composer.lock
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
@@ -7,6 +7,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 ## Table of contents
 
 - [Unreleased](#unreleased)
+- [1.0.5 - 2026-03-30](#105---2026-03-30)
   - [Changed](#changed)
 - [1.0.4 - 2026-03-13](#104---2026-03-13)
   - [Fixed](#fixed)
@@ -16,17 +17,23 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
   - [Added](#added-1)
   - [Changed](#changed-1)
 - [1.0.1 - 2026-03-12](#101---2026-03-12)
-  - [Added](#added-1)
+  - [Added](#added-2)
   - [Fixed](#fixed-1)
 - [1.0.0 - 2026-03-12](#100---2026-03-12)
-  - [Added](#added-2)
+  - [Added](#added-3)
   - [Security](#security)
 
 ## [Unreleased]
 
+## [1.0.5] - 2026-03-30
+
 ### Changed
 
-- **Documentation**: Corrected mask examples in README and USAGE (last four characters of `FAC-2025-01-00042` are `0042`). README requirements aligned with `composer.json` (PHP `< 8.6`). Makefile `help` lists `release-check-demos` as part of `release-check`. **DEMO-FRANKENPHP.md**: demo `bundles.php` example includes Twig Inspector (as in the repo demos). **SECURITY.md** rewritten in English to match the rest of the docs.
+- **Documentation and metadata:** GitHub URLs now use the real repository slug `nowo-tech/SerialNumberBundle` (the previous `nowo-tech/serial-number-bundle` path returned 404). The Composer package name remains `nowo-tech/serial-number-bundle`. Updated root `composer.json` (`homepage`, `support.*`) and demo `composer.lock` metadata for the path package.
+- **README:** Added [Version policy](https://github.com/nowo-tech/SerialNumberBundle#version-policy) (package name vs repo, SemVer, links to changelog and security policy). GitHub stars badge uses the correct repo slug.
+- **Demos:** `demo/README.md` default ports aligned with `.env.example` (Symfony 7 → 8007, Symfony 8 → 8008). [DEMO-FRANKENPHP.md](DEMO-FRANKENPHP.md) port section updated to match.
+- **Bug report template:** Links to version policy and security policy instead of a non-existent `#version-information` anchor.
+- **Documentation (carry-over from pre-release notes):** Mask examples in README/USAGE; README PHP constraint aligned with `composer.json` (`< 8.6`); Makefile `help` documents `release-check-demos` under `release-check`; DEMO-FRANKENPHP `bundles.php` example includes Twig Inspector; SECURITY.md in English.
 
 ## [1.0.4] - 2026-03-13
 
@@ -79,9 +86,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - Enforce single-character mask in config and in Twig mask filter (multi-char uses first character only).
 - Treat negative `visibleLast` in `serial_number_mask` as zero to prevent huge `str_repeat` output.
 
-[Unreleased]: https://github.com/nowo-tech/serial-number-bundle/compare/v1.0.4...HEAD
-[1.0.4]: https://github.com/nowo-tech/serial-number-bundle/releases/tag/v1.0.4
-[1.0.3]: https://github.com/nowo-tech/serial-number-bundle/releases/tag/v1.0.3
-[1.0.2]: https://github.com/nowo-tech/serial-number-bundle/releases/tag/v1.0.2
-[1.0.1]: https://github.com/nowo-tech/serial-number-bundle/releases/tag/v1.0.1
-[1.0.0]: https://github.com/nowo-tech/serial-number-bundle/releases/tag/v1.0.0
+[Unreleased]: https://github.com/nowo-tech/SerialNumberBundle/compare/v1.0.5...HEAD
+[1.0.5]: https://github.com/nowo-tech/SerialNumberBundle/releases/tag/v1.0.5
+[1.0.4]: https://github.com/nowo-tech/SerialNumberBundle/releases/tag/v1.0.4
+[1.0.3]: https://github.com/nowo-tech/SerialNumberBundle/releases/tag/v1.0.3
+[1.0.2]: https://github.com/nowo-tech/SerialNumberBundle/releases/tag/v1.0.2
+[1.0.1]: https://github.com/nowo-tech/SerialNumberBundle/releases/tag/v1.0.1
+[1.0.0]: https://github.com/nowo-tech/SerialNumberBundle/releases/tag/v1.0.0
diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
@@ -1,6 +1,6 @@
 # Contributing
 
-Contributions are welcome. Please open an issue or a pull request on the [GitHub repository](https://github.com/nowo-tech/serial-number-bundle).
+Contributions are welcome. Please open an issue or a pull request on the [GitHub repository](https://github.com/nowo-tech/SerialNumberBundle) (Composer package: `nowo-tech/serial-number-bundle`).
 
 - Follow PSR-12 and the project's PHP-CS-Fixer configuration.
 - Add tests for new behaviour. Tests live under `tests/Unit/` (isolated) and `tests/Integration/` (container/kernel). Run all with `make test`, or only `composer test-unit` / `composer test-integration`.
diff --git a/docs/DEMO-FRANKENPHP.md b/docs/DEMO-FRANKENPHP.md
@@ -38,7 +38,7 @@ The main difference between development and production is:
 | Symfony cache on startup | Cleared in Makefile before `up` | Not cleared (or warmup only) |
 | `APP_ENV` / `APP_DEBUG` | `dev` / `1` | `prod` / `0` |
 
-**Ports:** Each demo uses `PORT` from its `.env` (default **8001**). To run multiple demos at once, set a different `PORT` per demo (e.g. 8007 for symfony7, 8008 for symfony8) as per the bundle standard protocol.
+**Ports:** Each demo uses `PORT` from its `.env`. The checked-in `.env.example` uses **8007** for `demo/symfony7` and **8008** for `demo/symfony8` so both can run side by side. You may set any free port (e.g. `8001`) if you run a single demo.
 
 ---
 
diff --git a/docs/RELEASE.md b/docs/RELEASE.md
@@ -5,7 +5,7 @@ Maintainers: follow this checklist before creating a new tag.
 ## Pre-release checklist
 
 1. **Update version and docs**
-   - Ensure [CHANGELOG.md](CHANGELOG.md) has an entry for the new version (e.g. `[1.0.4] - YYYY-MM-DD`) and that `[Unreleased]` is updated or empty.
+   - Ensure [CHANGELOG.md](CHANGELOG.md) has an entry for the new version (e.g. `[1.0.5] - YYYY-MM-DD`) and that `[Unreleased]` is updated or empty.
    - Ensure [UPGRADING.md](UPGRADING.md) mentions any behaviour changes for that version if needed.
 
 2. **Run quality checks**
@@ -20,20 +20,20 @@ Maintainers: follow this checklist before creating a new tag.
 
    ```bash
    git status
-   git add -A && git commit -m "Release v1.0.4"   # if needed
+   git add -A && git commit -m "Release v1.0.5"   # if needed
    git push origin main
    ```
 
 ## Tag and publish
 
-4. **Create an annotated tag** (replace with the version you are releasing, e.g. `v1.0.4`). Ensure you have at least one commit before tagging:
+4. **Create an annotated tag** (replace with the version you are releasing, e.g. `v1.0.5`). Ensure you have at least one commit before tagging:
 
    ```bash
-   git tag -a v1.0.4 -m "Release v1.0.4"
-   git push origin v1.0.4
+   git tag -a v1.0.5 -m "Release v1.0.5"
+   git push origin v1.0.5
    ```
 
-   If the bundle is developed in a monorepo and released from a separate clone (e.g. `nowo-tech/serial-number-bundle`), run these commands in the clone that is pushed to the release remote.
+   If the bundle is developed in a monorepo and released from a separate clone (e.g. `nowo-tech/SerialNumberBundle`), run these commands in the clone that is pushed to the release remote.
 
 5. **GitHub release**  
    The [release workflow](.github/workflows/release.yml) runs on tag push and creates the GitHub Release (including “Latest”) with body from the tag message and [CHANGELOG.md](CHANGELOG.md). No manual draft needed unless you want to edit the notes.
diff --git a/docs/UPGRADING.md b/docs/UPGRADING.md
@@ -2,13 +2,18 @@
 
 ## Table of contents
 
+- [From 1.0.4 to 1.0.5](#from-104-to-105)
 - [From 1.0.3 to 1.0.4](#from-103-to-104)
 - [From 1.0.2 to 1.0.3](#from-102-to-103)
 - [From 1.0.1 to 1.0.2](#from-101-to-102)
 - [From 1.0.0 to 1.0.1](#from-100-to-101)
 - [From 0.x / pre-1.0 to 1.0](#from-0x--pre-10-to-10)
   - [Behaviour and limits in 1.0](#behaviour-and-limits-in-10)
 
+## From 1.0.4 to 1.0.5
+
+No breaking changes. Documentation and repository metadata only: correct GitHub URLs (`nowo-tech/SerialNumberBundle`), demo default ports in docs (8007 / 8008 per `.env.example`), README version policy, and bug-report template links. The Composer package name is still `nowo-tech/serial-number-bundle`.
+
 ## From 1.0.3 to 1.0.4
 
 No breaking changes. Demo Symfony 7 only: Composer audit config and routing file extensions (`.xml`) so the demo runs with Symfony 7.1.x and `composer update` / `cache:clear` succeed.
