> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mov-eat.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Documentation operations

> How Moveat documentation is maintained, branded and prepared for future bilingual support.

# Documentation operations

The `docs` repository is the source of truth for Moveat documentation. Mintlify renders and hosts the site, but the repository owns the content.

## Current setup

| Setting     | Value                     |
| ----------- | ------------------------- |
| Hosting     | Mintlify.                 |
| Domain      | `docs.mov-eat.app`.       |
| Source repo | `moveatApp/docs`.         |
| Branch      | `main`.                   |
| Config file | `docs.json` at repo root. |
| Languages   | English and Spanish.      |

## Branding

The header logo is configured in `docs.json` through the `logo` field. Mintlify supports separate light and dark logo files, but Moveat currently uses the same `logo.png` for both modes.

If the logo does not render correctly in one color mode, add separate assets:

```txt theme={null}
/logo-light.png
/logo-dark.png
```

Then configure:

```json theme={null}
"logo": {
  "light": "/logo-light.png",
  "dark": "/logo-dark.png",
  "href": "/"
}
```

## Bilingual documentation

Moveat documentation is available in English and Spanish. The English version lives at the repository root and the Spanish version lives under `es/` with the same structure.

When content changes:

1. Update the English source page.
2. Update the matching Spanish page.
3. Validate `docs.json` navigation.
4. Push and verify the Mintlify deployment.

This keeps both language versions aligned while preserving one repository as the source of truth.

## Content ownership

| Content type            | Owner                                                   |
| ----------------------- | ------------------------------------------------------- |
| Product logic           | Product/Founder plus engineering review.                |
| Platform technical docs | Backend engineering.                                    |
| Agent technical docs    | Agent engineering.                                      |
| Deployment and infra    | Operations/backend engineering.                         |
| Testing status          | Engineering, updated after meaningful coverage changes. |
| API specs               | Generated from Platform Swagger/OpenAPI when possible.  |

## Update workflow

1. Update MDX files in the docs repository.
2. Validate navigation references in `docs.json`.
3. Commit and push to `main` or open a PR.
4. Wait for Mintlify deploy.
5. Verify the live page at `docs.mov-eat.app`.