spelling

Author: TOEL2

DEPLOYMENT.md

@@ -2,14 +2,14 @@
 
 This repo uses GitHub Actions to deploy through four environments:
 
-- **dev** – continuous integration deploys on push to `main`. Creates a `dev-<timestamp>` tag.
-- **test** – manual deploy of an existing tag (usually a `dev-<timestamp>` tag). No releases or SemVer tags.
-- **preprod** – manual deploy that **cuts/bumps a Release Candidate (RC)** tag (`vX.Y.Z-rc.N`) and creates a **GitHub pre-release**.
+- **Dev** – continuous integration deploys on push to `main`. Creates a `Dev-<timestamp>` tag.
+- **test** – manual deploy of an existing tag (usually a `Dev-<timestamp>` tag). No releases or SemVer tags.
+- **Preprod** – manual deploy that **cuts/bumps a Release Candidate (RC)** tag (`vX.Y.Z-rc.N`) and creates a **GitHub pre-release**.
 - **prod** – manual promotion of a specific RC to a **final SemVer tag** (`vX.Y.Z`) and a **GitHub Release**.
 
 Releases are immutable and auditable:
 
-- **RC tags** live only in preprod.
+- **RC tags** live only in Preprod.
 - **Final tags** (`vX.Y.Z`) live only in prod and point to the exact commit that shipped.
 
 ---
@@ -19,12 +19,12 @@ Releases are immutable and auditable:
 | Stage            | Workflow file                                                           | Trigger                               | What it does                                                    | Tags / Releases                             |
 |------------------|-------------------------------------------------------------------------|---------------------------------------|-----------------------------------------------------------------|---------------------------------------------|
 | **Pull Request** | `.github/workflows/cicd-1-pull-request.yml`                             | `pull_request` (opened/sync/reopened) | Commit/Test/Build/Acceptance stages                             | No tags/releases                            |
-| **Dev**          | `.github/workflows/cicd-2-publish.yml`                                  | `push` to `main`                      | Builds & deploys to dev                                         | Creates and pushes `dev-YYYYMMDDHHMMSS` tag |
+| **Dev**          | `.github/workflows/cicd-2-publish.yml`                                  | `push` to `main`                      | Builds & deploys to Dev                                         | Creates and pushes `Dev-YYYYMMDDHHMMSS` tag |
 | **Test**         | `.github/workflows/cicd-3-test.yml`                                     | Manual (`workflow_dispatch`)          | Deploys the chosen tag to test                                  | No tags, no releases                        |
-| **Preprod**      | `.github/workflows/cicd-4-preprod-deploy.yml` → calls `base-deploy.yml` | Manual (`workflow_dispatch`)          | Deploys chosen ref and **creates/bumps an RC tag**; pre-release | `vX.Y.Z-rc.N` + GitHub **pre-release**      |
+| **Preprod**      | `.github/workflows/cicd-4-Preprod-deploy.yml` → calls `base-deploy.yml` | Manual (`workflow_dispatch`)          | Deploys chosen ref and **creates/bumps an RC tag**; pre-release | `vX.Y.Z-rc.N` + GitHub **pre-release**      |
 | **Prod**         | `.github/workflows/cicd-5-prod-deploy.yml` → calls `base-deploy.yml`    | Manual (`workflow_dispatch`)          | Promotes a specific RC to final                                 | `vX.Y.Z` + GitHub **Release**               |
 
-> **Note:** The preprod/prod entry workflows are thin wrappers around a **reusable** workflow (`base-deploy.yml`).
+> **Note:** The Preprod/prod entry workflows are thin wrappers around a **reusable** workflow (`base-deploy.yml`).
 
 ---
 
@@ -47,11 +47,11 @@ Releases are immutable and auditable:
 **File:** `CI/CD publish`
 **Trigger:** push to `main`
 
-- Builds & deploys to **dev**.
-- Creates a timestamped **dev tag**: `dev-YYYYMMDDHHMMSS`
+- Builds & deploys to **Dev**.
+- Creates a timestamped **Dev tag**: `Dev-YYYYMMDDHHMMSS`
 - No SemVer, no GitHub Release.
 
-**Why:** fast feedback and a stable pointer (the dev tag) you can later promote to **test** or use as the **preprod ref**.
+**Why:** fast feedback and a stable pointer (the Dev tag) you can later promote to **test** or use as the **Preprod ref**.
 
 ---
 
@@ -62,7 +62,7 @@ Releases are immutable and auditable:
 
 ### Inputs
 
-- `tag`: the ref to deploy (e.g., a **dev** tag created by the dev workflow).
+- `tag`: the ref to deploy (e.g., a **Dev** tag created by the Dev workflow).
 - `environment`: fixed to `test`.
 
 ### Behavior
@@ -72,18 +72,18 @@ Releases are immutable and auditable:
 
 ### Recommended usage
 
-- Deploy the **same commit** that was verified in dev by supplying the `dev-<timestamp>` tag here.
+- Deploy the **same commit** that was verified in Dev by supplying the `Dev-<timestamp>` tag here.
 
 ---
 
 ## Preprod (Release Candidates)
 
-**Entry workflow:** `cicd-4-preprod-deploy.yml` → calls `base-deploy.yml`
+**Entry workflow:** `cicd-4-Preprod-deploy.yml` → calls `base-deploy.yml`
 **Trigger:** manual (`workflow_dispatch`)
 
 ### Inputs
 
-- **`ref`**: branch/tag/SHA to deploy (`dev-<timestamp>` tag).
+- **`ref`**: branch/tag/SHA to deploy (`Dev-<timestamp>` tag).
 - **`release_type`**: one of:
   - `patch` – start a new **patch** series → `vX.Y.(Z+1)-rc.1`
   - `minor` – start a new **minor** series → `vX.(Y+1).0-rc.1`
@@ -93,7 +93,7 @@ Releases are immutable and auditable:
 ### Behavior
 
 - Tags the **checked-out commit** as the next **RC** (`vX.Y.Z-rc.N`) and pushes it.
-- Deploys to **preprod**.
+- Deploys to **Preprod**.
 - Creates a **GitHub pre-release** for that RC.
 
 ### When to use which `release_type`
@@ -125,40 +125,40 @@ Releases are immutable and auditable:
 
 | Situation                                       | Workflow             | Input: `ref`                 | Input: `release_type` | Result                                       |
 |-------------------------------------------------|----------------------|------------------------------|-----------------------|----------------------------------------------|
-| Deploy automatically after merge to main        | **Dev** (auto)       | `main` (implicit)            | n/a                   | Deploys to dev, creates `dev-YYYYMMDDHHMMSS` |
-| Deploy an existing build to test                | **Test** (manual)    | a tag (e.g. `dev-20250817…`) | n/a                   | Deploys to test (no tags/releases)           |
-| Start a **new patch release** into preprod      | **Preprod** (manual) | branch/tag/SHA               | `patch`               | `vX.Y.(Z+1)-rc.1` + pre-release              |
-| Start a **new minor release** into preprod      | **Preprod**          | branch/tag/SHA               | `minor`               | `vX.(Y+1).0-rc.1` + pre-release              |
-| Start a **new major release** into preprod      | **Preprod**          | branch/tag/SHA               | `major`               | `v(X+1).0.0-rc.1` + pre-release              |
+| Deploy automatically after merge to main        | **Dev** (auto)       | `main` (implicit)            | n/a                   | Deploys to Dev, creates `Dev-YYYYMMDDHHMMSS` |
+| Deploy an existing build to test                | **Test** (manual)    | a tag (e.g. `Dev-20250817…`) | n/a                   | Deploys to test (no tags/releases)           |
+| Start a **new patch release** into Preprod      | **Preprod** (manual) | branch/tag/SHA               | `patch`               | `vX.Y.(Z+1)-rc.1` + pre-release              |
+| Start a **new minor release** into Preprod      | **Preprod**          | branch/tag/SHA               | `minor`               | `vX.(Y+1).0-rc.1` + pre-release              |
+| Start a **new major release** into Preprod      | **Preprod**          | branch/tag/SHA               | `major`               | `v(X+1).0.0-rc.1` + pre-release              |
 | Cut **another candidate** for the **same base** | **Preprod**          | branch/tag/SHA (same train)  | `rc`                  | `vX.Y.Z-rc.N+1` + pre-release                |
 | Promote a **tested RC** to production           | **Prod** (manual)    | RC tag (e.g. `v1.4.0-rc.2`)  | n/a                   | `v1.4.0` + GitHub Release                    |
 
 ---
 
 ## Versioning Rules
 
-- **Dev tags**: `dev-YYYYMMDDHHMMSS` (automation convenience; never promoted to prod directly).
-- **RC tags**: `vX.Y.Z-rc.N` (preprod only; immutable; one per candidate).
+- **Dev tags**: `Dev-YYYYMMDDHHMMSS` (automation convenience; never promoted to prod directly).
+- **RC tags**: `vX.Y.Z-rc.N` (Preprod only; immutable; one per candidate).
 - **Final tags**: `vX.Y.Z` (prod only; immutable; exactly what shipped).
 
 ### Promotion path
 
-- Choose a commit (often via a **dev tag**) → cut RC(s) in **preprod** → promote the selected RC to **prod**.
+- Choose a commit (often via a **Dev tag**) → cut RC(s) in **Preprod** → promote the selected RC to **prod**.
 
 ---
 
 ## Common Q&A
 
-**Can I use a dev tag as the preprod `ref`?**
-Yes. `ref` can be any branch/tag/SHA. Using a `dev-<timestamp>` tag guarantees you deploy the **same commit** previously built on dev.
+**Can I use a Dev tag as the Preprod `ref`?**
+Yes. `ref` can be any branch/tag/SHA. Using a `Dev-<timestamp>` tag guarantees you deploy the **same commit** previously built on Dev.
 
 **What does `rc` mean?**
 **Release Candidate**: a build that could become the final version if it passes testing. Each new candidate for the same base version increments the suffix: `-rc.1`, `-rc.2`, …
 
-**What if I already have `v1.4.0-rc.1` and I need another preprod build for the same release?**
+**What if I already have `v1.4.0-rc.1` and I need another Preprod build for the same release?**
 Run **Preprod Deploy** with `release_type=rc` to get `v1.4.0-rc.2`.
 
-**What if I discover issues after preprod?**
+**What if I discover issues after Preprod?**
 Fix, then cut a new RC (`-rc.N+1`). Only promote to prod when ready.
 
 ---
@@ -167,8 +167,8 @@ Fix, then cut a new RC (`-rc.N+1`). Only promote to prod when ready.
 
 ### New minor release
 
-1. Dev (auto) → creates `dev-20250818…`.
-2. Preprod (manual) → `ref=dev-20250818…`, `release_type=minor` → `v1.4.0-rc.1`.
+1. Dev (auto) → creates `Dev-20250818…`.
+2. Preprod (manual) → `ref=Dev-20250818…`, `release_type=minor` → `v1.4.0-rc.1`.
 3. Preprod (manual) → `release_type=rc` → `v1.4.0-rc.2`.
 4. Prod (manual) → `ref=v1.4.0-rc.2` → final `v1.4.0`.
 

scripts/config/vale/styles/config/vocabularies/words/accept.txt

@@ -30,9 +30,6 @@ Pydantic
 yanai
 Portman
 repo
-dev
 Preprod
 Dev
 auditable
-DEV
-preprod