feat: bootstrap Eldorado documentation and Pages publication

README.md

@@ -1,3 +1,30 @@
-# documentation
+# Eldorado documentation
 
-Eldorado documentation foundation · Docusaurus · LEGO Cloud Pages
+A Docusaurus foundation. The documentation’s purpose and audience are intentionally undecided.
+
+- Site: https://pages.apps.lego-cloud.eu/eldorado-v1/documentation/
+- Repository: https://gitea.lego-cloud.eu/eldorado-v1/documentation (private)
+- Channel: https://discord.com/channels/1518726359512387766/1555510466904727622
+
+## Development
+
+Use Node.js 22+ and pnpm 10.15.1.
+
+```sh
+pnpm install --frozen-lockfile
+pnpm start
+pnpm verify
+pnpm typecheck
+pnpm build
+pnpm verify:build
+```
+
+## CI and publication
+
+Pull requests validate only. Pushes to `main` validate, build, and publish to the persistent runner mount at `/gondor-v1-gitea-pages/eldorado-v1/documentation/`, following `corp-v1/portal`. Publication fails if that mount is unavailable. The Pages platform controls user authentication independently of repository visibility. No infrastructure or authentication changes are required.
+
+After publication, verify the exact commit’s Actions task and deployed page body; an OAuth redirect is not content verification. Future changes should use pull requests. Never commit credentials or edit generated `build/` output.
+
+## Design
+
+Inspired by https://www.eldorado.gg/: Lato, near-black navigation, charcoal, gold `#ffc950`, light panels, bold headings. Original documentation artwork and square panels; no official marketplace assets or business claims. See `docs/reference.md`.