37 lines
1.8 KiB
Markdown
37 lines
1.8 KiB
Markdown
# AGENTS.MD
|
|
|
|
Publish mirror for `docs.openclaw.ai`. Source repo: `openclaw/openclaw`.
|
|
|
|
## Rule
|
|
|
|
- Do not hand-edit generated docs output.
|
|
- Fix source or workflow; let sync/translation regenerate.
|
|
- Emergency generated-output edits need explicit owner approval and a follow-up source/workflow fix.
|
|
|
|
## Editable Here
|
|
|
|
- `AGENTS.md`, `CLAUDE.md`, `README.md`.
|
|
- `.github/workflows/translate-*.yml`.
|
|
- `.github/workflows/translate-locale-reusable.yml`.
|
|
- `docs/.i18n/translation-workflow.md` when documenting translation workflow internals.
|
|
- `docs/.i18n/glossary.<locale>.json` when adding fixed glossary terms for the translation workflow.
|
|
|
|
## Do Not Edit Here
|
|
|
|
- English docs under `docs/**`; edit `openclaw/openclaw/docs/**` instead.
|
|
- `docs/docs.json`; generated by source sync.
|
|
- Locale pages under `docs/<locale>/**`; generated by translation workflows.
|
|
- Translation memory `docs/.i18n/*.tm.jsonl`; generated by translation workflows.
|
|
- Locale navigation files `docs/.i18n/*-navigation.json`; generated workflow state.
|
|
- `.openclaw-sync/source.json`; generated sync metadata.
|
|
- `.openclaw-sync/check-docs-mdx.mjs` and `.openclaw-sync/docs-mdx-repair.md`; copied from `openclaw/openclaw`.
|
|
|
|
## Workflow
|
|
|
|
- Source sync starts in `openclaw/openclaw/.github/workflows/docs-sync-publish.yml`.
|
|
- Sync mirrors `openclaw/openclaw/docs/**` into this repo and updates `.openclaw-sync/source.json`.
|
|
- `translate-all.yml` runs from this repo after debounced docs changes, weekly schedule, release dispatch, or manual dispatch.
|
|
- Translation pending logic compares source file SHA-256 with each page's `x-i18n.source_hash`.
|
|
- Locale workers upload artifacts; the finalizer pushes one aggregate i18n commit.
|
|
- If translated MDX fails, the repair step may touch only `docs/<locale>/**` and `docs/.i18n/<locale>.tm.jsonl`.
|