# Improve these docs

Improve installation instructions, configuration examples and troubleshooting guides.

Use the shared [Dicto repository](https://github.com/TruhnLab/Dicto) to improve
these guides. Include the relevant app and server versions when reporting a
documentation issue.

## Improve a guide

Edit Markdown under `content/`. Give each guide a title, description,
intended audience, prerequisites and a useful verification step. Keep links
relative to the published site and identify the applicable component versions
when the instructions depend on a release. Run `just check` before proposing a change.

## Report a problem

Include your app version, server version, platform, expected behavior, steps to
reproduce and the result. Use synthetic examples and remove account information,
credentials and sensitive content from screenshots or logs.

## Update configuration downloads

The reusable Hippo docs image owns rendering, search and verification. This
repository supplies content and `docs.yaml`; no Dart or Flutter source is needed
to build it.

Configuration schemas are generated exports. Request an update from the
owning product package instead of editing these files by hand. Maintainers export
the reviewed artifacts from Dicto-Dev and update their checksums together.