# Eldorado documentation

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`.