Modern software development teams maintain several git repositories. If they commit to having documentation close to the code, they will inevitably have documentation spread over several repositories. DocToolchain supports building documentation such as a microsite from several repositories precisely by not supporting it in any particular way. You can just checkout all repositories you need, and extract and arrange the content of their docs folders as you need before you build the documentation.

DocToolchain offers two helpful links in the top right corner of every page:

The URLs for both activities can be specified in docToolchainConfig.groovy, in the fields issueUrl and gitRepoUrl. However, if you build your documentation from several repos, you’ll want to link to different repos.

A simple fix is to do a postprocessing step with sed and replace the default URLs with the correct ones. If your way of arranging the documentation folders from the different repos is simple enough, you can simply run sed with a different URL on each of the different generated folders.

If your arrangement is more complicated, e.g. because you merge all repos ADRs into one folder, you can do a preprocessing step in advance.