# Publishing workflow

The GitHub repository is the source of truth for this documentation.

## Production changes

1. Make and preview your changes locally.
2. Commit them to Git.
3. Push the commit to `main`, or merge a pull request into `main`.
4. Redocly automatically starts a production build.
5. When the build succeeds, Redocly deploys the updated site.


## Review changes safely

For larger changes, work on a separate branch and open a pull request. Redocly can create a preview deployment for the branch so reviewers can inspect the rendered result before it reaches production.

## Troubleshooting

If a deployment fails, open **Deployments** in Redocly and inspect the build log. Common causes include invalid YAML, broken internal links, and an invalid OpenAPI description.