feat: bootstrap Eldorado documentation and Pages publication

docs/reference.md

@@ -0,0 +1,39 @@
+---
+title: Site configuration reference
+description: Look up source locations, tool versions, styling choices, and publication settings.
+slug: /reference
+---
+
+## Repository layout
+
+| Path | Responsibility |
+| --- | --- |
+| `docs/` | Documentation Markdown |
+| `src/pages/index.tsx` | Homepage |
+| `src/css/custom.css` | Eldorado-inspired theme |
+| `static/img/docs-mark.svg` | Original documentation icon |
+| `docusaurus.config.ts` | Routes, metadata, navigation, and search |
+| `sidebars.ts` | Documentation navigation |
+| `scripts/verify.mjs` | Source and built-output contract checks |
+| `.gitea/workflows/pages.yml` | Validation and Pages publication |
+
+## Runtime and publication
+
+| Setting | Value |
+| --- | --- |
+| Framework | Docusaurus 3.10.2 |
+| Node.js | 22 or later; CI uses 22 |
+| Package manager | pnpm 10.15.1 |
+| Base path | `/eldorado-v1/documentation/` |
+| Repository | `eldorado-v1/documentation` (private) |
+| Publication branch | `main` |
+| Pages mount | `/gondor-v1-gitea-pages` |
+| Search | Local build-generated index; no external search service |
+
+## Visual reference
+
+The theme adapts [Eldorado’s website](https://www.eldorado.gg/): near-black navigation, charcoal surfaces, gold `#ffc950` accents, light `#f6f6f6` backgrounds, and Lato type. Gold buttons use dark text; light-mode text links use a darker gold for contrast. Fonts are bundled locally.
+
+The documentation uses original page artwork and a document icon, not marketplace imagery, commercial copy, or the official logo. Square panels follow the workspace’s existing design preference. This is a documentation workspace, not the public Eldorado marketplace.
+
+The publication workflow follows the persistent-mount pattern in [corp-v1/portal](https://gitea.lego-cloud.eu/corp-v1/portal/src/branch/main/.gitea/workflows/pages.yml).