Contribute to docs
This repository mixes currentOpenClaw docs, preserved Trellis workflow docs, and curated learning material. Improve clarity in place. Do not remove legacy material unless the change is explicitly about cleanup or migration.
Repository content model
| Track | Status | How to edit it |
|---|---|---|
openclaw/ and zh/openclaw/ | Current maintained track | Keep the reading path clear and update both languages when both pages already exist |
guide/, zh/guide/, guides/, zh/guides/ | Preserved Trellis legacy docs | Preserve routes, keep the historical context, and prefer clarification over deletion |
ml/ and archived imports | Curated entry pages plus raw preserved material | Improve the entry pages first; only promote raw files after cleanup, frontmatter, and link repair |
Local workflow
- Fork and clone the repository.
- Install the Mintlify CLI if you do not already have it.
- Start the local preview.
- Validate before opening a PR.
What usually changes together
- Content pages in folders such as
openclaw/,zh/openclaw/,guide/,zh/guide/,guides/, andzh/guides/ - Navigation and labels in
docs.json - Images and static assets in
public/,images/, andlogo/ - Bilingual pairs for user-facing OpenClaw pages when both language tracks already exist
Contribution rules
- Use relative links for pages and assets inside the same section or tutorial sequence.
- Use root-relative links for jumps across major sections.
- Never link to
.mdor.mdxfiles directly. - Add new pages to
docs.jsonor they will stay hidden. - Prefer improving existing pages over creating parallel pages.
- Keep code examples free of secrets, private tokens, and internal endpoints.
- If you touch a user-facing OpenClaw page and the matching page exists in the other language, update both.
- If you are editing legacy Trellis content, preserve the route and explain legacy status instead of deleting history.
- If you are editing archived material, add or improve a maintained MDX entry page before exposing more raw files in navigation.
Recommended review checklist
- Frontmatter includes
titleanddescription. - New or moved pages are registered in
docs.json. - Internal links and assets follow the section-relative or cross-section rule above.
mint broken-linkspasses.mint validatepasses.- The page still matches the surrounding section and language style.
Good contribution targets
- Broken links or navigation drift
- Outdated setup instructions
- Thin landing pages that need clearer entry points
- Better bilingual parity in
openclaw/andzh/openclaw/ - Cleaner descriptions and frontmatter for discovery and search
Issues and pull requests
Found a problem with the docs? Open an issue: https://github.com/lilinji/GeneTind-docs/issues Include:- Which page has the issue
- What is wrong or confusing
- A suggested fix if you have one