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

# Contributing to TruAgents Docs

> How to update the TruAgents docs safely and keep the public documentation consistent.

## Summary

Use this page when you are changing navigation, writing new pages, updating existing guides, or deciding where new documentation should live.

## Who this is for

Internal contributors maintaining the docs site and content standards.

## Core contributor rules

* keep user-facing docs centered on product workflows, not code structure
* prefer stable product concepts over unstable route names
* treat **Communications** as the main operating story for channel activity
* keep future-facing developer docs honest about what is and is not public yet
* keep the preserved Mintlify starter content clearly separated from real TruAgents docs

## Before you add a new page

* confirm the page belongs in the approved information architecture in `docs.json`
* check whether the topic already fits inside an existing page instead of creating thin extra pages
* make sure the title uses product language users will understand
* link the page to adjacent setup, workflow, concept, or reference docs

## Before you publish docs changes

* verify that the page still matches the current product story
* remove or rewrite placeholder wording if the page is now meant to be genuinely useful
* confirm links and related-page sections still point to the strongest canonical docs
* prefer plain English before technical detail

## Simple version

Add pages only when they clarify the product, not just because the nav has room.

## Related pages

* [Content style guide](/internal/content-style-guide)
* [Page template guide](/internal/page-template-guide)