branding related updates

Author: Xor-el

assets/branding/BRAND.md

@@ -2,8 +2,8 @@
 
 ## Primary mark
 
-- **Default:** `logo.svg` — **scan frame** around a **white QR tile**: cyan **corner brackets** (viewfinder) and a **6×6 module** pattern (stylized, not a real payload). Reads as **QR generation / encoding**, not a scanner app icon alone.
-- **Dark UI:** `logo-dark.svg` — same layout on a **near-black** badge, **slate** inner tile, **light** modules, **bright cyan** frame.
+- **Default:** [`logo.svg`](logo.svg) — **scan frame** around a **white QR tile**: cyan **corner brackets** (viewfinder) and a **6×6 module** pattern (stylized, not a real payload). Reads as **QR generation / encoding**, not a scanner app icon alone.
+- **Dark UI:** [`logo-dark.svg`](logo-dark.svg) — same layout on a **near-black** badge, **slate** inner tile, **light** modules, **bright cyan** frame.
 
 **QR Code** is a registered trademark of **DENSO WAVE INCORPORATED**. This mark is an original graphic for the library project; it does not imply endorsement by Denso Wave.
 
@@ -19,7 +19,7 @@
 
 Dark variant uses `#0f172a`–`#020617`, tile `#1e293b`, frame `#67e8f9`, modules `#e2e8f0`.
 
-**Banner background** (flat fill behind the logo in wide `export/*.png` social / OG assets): RGB **13, 74, 110** (`#0d4a6e`) — aligned with the default badge teal; +1 red vs `#0c4a6e` so the squircle rim is visible on composites.
+**Banner background** (flat fill behind the logo for wide social and Open Graph PNGs [here](export/)): RGB **13, 74, 110** (`#0d4a6e`) — aligned with the default badge teal; +1 red vs `#0c4a6e` so the squircle rim is visible on composites.
 
 ## Typography (pairing)
 
@@ -46,7 +46,7 @@ Keep padding around the badge at least **1/4 of the mark’s width** (e.g. ~32 p
 ## Incorrect use
 
 - Do not **stretch** or **skew** the badge.
-- Do not **change hue** arbitrarily without updating this doc.
+- Do not **change hue** arbitrarily (keep palette cohesive with the table above or update this doc when rebranding).
 - Do not **crop** away the rounded corners entirely.
 - Do not imply **QR Code trademark** ownership; attribute the standard where appropriate in docs.
 

assets/branding/README.md

@@ -15,11 +15,11 @@ It is **not** the official QR Code logo and is **not** affiliated with Denso Wav
 
 | File | Use |
 |------|-----|
-| `logo.svg` | **Source of truth** (light UI / default README). |
-| `logo-dark.svg` | Dark backgrounds (docs, dark-themed pages). |
-| `BRAND.md` | Colors, clear space, minimum size, do / don’t. |
-| `export/*.png` | Raster exports (GitHub social 2:1, Open Graph, social header, square avatar). |
-| `icons/QRCodeGenLib4Pascal.ico` | Multi-resolution Windows icon for `.dproj` / `.lpi`. |
+| [`logo.svg`](logo.svg) | **Source of truth** (light UI / default README). |
+| [`logo-dark.svg`](logo-dark.svg) | Dark backgrounds (docs, dark-themed pages). |
+| [`BRAND.md`](BRAND.md) | Colors, clear space, minimum size, do / don’t. |
+| [`export/`](export/) (`*.png`) | Raster exports (GitHub social 2:1, Open Graph, social header, square avatar). |
+| [`icons/QRCodeGenLib4Pascal.ico`](icons/QRCodeGenLib4Pascal.ico) | Multi-resolution Windows icon for `.dproj` / `.lpi`. |
 
 ## License
 
@@ -29,7 +29,5 @@ The **library source code** is under the project [MIT License](../../LICENSE). T
 
 If you change the SVG, regenerate rasters using one of:
 
-- **Inkscape** (CLI): export PNG at the sizes listed in `export/README.md`.
-- **ImageMagick** 7+: `magick logo.svg -resize 512x512 export/logo-512.png` (and similar).
-
-Exact filenames and pixel sizes are listed in `export/README.md`.
+- **Inkscape** (CLI): export PNG at the sizes [listed here](export/README.md).
+- **ImageMagick** 7+: `magick logo.svg -resize 512x512 export/logo-512.png`.

assets/branding/export/README.md

@@ -1,13 +1,13 @@
 # Raster exports
 
-PNG files in this folder are **generated from** `../logo.svg`.
+PNG files in this folder are generated from [this logo](../logo.svg).
 
 | File | Size | Typical use |
 |------|------|-------------|
-| `og-1280x640.png` | 1280×640 | **GitHub social preview** (recommended; 2:1) |
-| `og-640x320.png` | 640×320 | GitHub social preview **minimum** size (2:1) |
-| `og-1200x630.png` | 1200×630 | Open Graph / general link previews |
-| `social-header-1500x500.png` | 1500×500 | Twitter/X-style header |
-| `logo-512.png` | 512×512 | Profile / square avatar |
+| [`og-1280x640.png`](og-1280x640.png) | 1280×640 | **GitHub social preview** (recommended; 2:1) |
+| [`og-640x320.png`](og-640x320.png) | 640×320 | GitHub social preview **minimum** size (2:1) |
+| [`og-1200x630.png`](og-1200x630.png) | 1200×630 | Open Graph / general link previews |
+| [`social-header-1500x500.png`](social-header-1500x500.png) | 1500×500 | Twitter/X-style header |
+| [`logo-512.png`](logo-512.png) | 512×512 | Profile / square avatar |
 
-Regenerate after SVG changes using Inkscape or ImageMagick.
+Regenerate after SVG changes using Inkscape or ImageMagick; the full steps are [described here](../README.md).

assets/branding/icons/README.md

@@ -2,13 +2,13 @@
 
 | File | Contents |
 |------|-----------|
-| `QRCodeGenLib4Pascal.ico` | Multi-size Windows icon (16, 32, 48, 256), generated from `../logo.svg`. |
+| [`QRCodeGenLib4Pascal.ico`](QRCodeGenLib4Pascal.ico) | Multi-size Windows icon (16, 32, 48, 256), generated from [this logo](../logo.svg). |
 
 ## Using in Delphi (`.dproj`)
 
 1. Open the project in the IDE.
 2. **Project → Options → Application** (or **Icons** depending on version).
-3. Set **Application icon** to `assets\branding\icons\QRCodeGenLib4Pascal.ico` (adjust path relative to the `.dproj`).
+3. Set **Application icon** to [`QRCodeGenLib4Pascal.ico`](QRCodeGenLib4Pascal.ico) (path relative to the `.dproj`; from the repo root that is `assets/branding/icons/QRCodeGenLib4Pascal.ico`).
 
 Alternatively, your `.dproj` may contain an `<Icon_MainIcon>` or similar property pointing at an `.ico` file; set it to a path **relative to the project file** (you may copy the icon next to the `.dproj` if the IDE resolves paths more reliably that way).
 
@@ -19,4 +19,4 @@ Alternatively, your `.dproj` may contain an `<Icon_MainIcon>` or similar propert
 
 ## Regeneration
 
-After changing `../logo.svg`, rebuild the ICO with the same raster workflow as in `../README.md` (Inkscape or ImageMagick, then combine sizes into a multi-resolution `.ico` if your tool does not do that in one step).
+When [this logo](../logo.svg) changes, rebuild the ICO with **Inkscape** or **ImageMagick** following the workflow [described here](../README.md), then combine sizes into a multi-resolution `.ico` if your tool does not do that in one step.