Cosmos Documentation Hub

A work in progress, striving to unify and provide a single source of truth for all documentation encompassing the broader Cosmos stack.

Contributing

Fork the repository

• Click “Fork” in the GitHub UI to create your own copy.

Clone your fork

   git clone https://github.com/<your-username>/cosmos-docs.git
   cd cosmos-docs

Create a branch

   git checkout -b my-feature

Make your changes

• Edit or add files under docs/ as needed.
• Follow existing file structure and naming conventions.
• Ensure Markdown is valid and links resolve.

Local testing & validation

   # Start a live-reload preview
   npx mint dev

   # Check for broken internal links
   npx mint broken-links

   # Validate OpenAPI specs (if applicable)
   npx mint openapi-check path/to/openapi.yaml

Source: Mintlify CLI docs

Commit and push

   git add .
   git commit -m "Brief description of your change"
   git push origin my-feature

Open a Pull Request

• On GitHub, navigate to your fork.
• Click “Compare & pull request.”
• Provide a concise title and description.
• Submit the PR for review.