Keep documentation up to date
Documentation is only useful while it matches the code. dev-doc gives you two ways to update a project: re-analyse the copy you imported, or refresh from the repository when it is tracked.
Re-analyse a project
On My Projects, each card has a Reanalyse line with a mode and a play button.
- Pick the modeClick the word incremental or complete to switch between them.
- Click the play buttonA confirmation dialog states the mode, and asks again whether to include codebase analysis (your previous choice is pre-selected).
- ConfirmThe run starts; follow it on the card.
| Incremental | Complete | |
|---|---|---|
| What it does | Keeps the existing analysis and fills the gaps. | Rebuilds the analysis and regenerates the documentation. |
| Cost | Only for the work that is missing. | The whole project is billed again. |
| Use it when | A run was stopped or failed part-way, or you now want codebase analysis too. | You switched to a higher pricing model, or want everything written fresh. |
| Your edits | Untouched. | You choose which approved/edited sections to keep. |
Track a repository
Tracking links a project to its repository, so you can bring the documentation up to date with new commits in one click. Turn it on in the import confirmation dialog (Track this repository for updates), or later with Connect repository on the project's card.
When a repository is connected, the card offers:
- 🔄 Refresh documentation — downloads the latest commit and updates the affected documentation incrementally.
- Check for updates — asks the repository whether newer commits exist, so you know if a refresh is worthwhile.
- Edit connection — change the repository address, the branch, or the access token (for example after a token expired).
- Disconnect — stop tracking. The documentation stays.
On a project shared with you through a workgroup, the card shows the same status and Check for updates. Refresh documentation needs the Run & stop analyses right, and only the owner can connect, edit or disconnect the repository.