Hello,

TF-M documentation reflects the documents in the main TF-M repository (https://git.trustedfirmware.org/TF-M/trusted-firmware-m.git/tree/docs) only.

There are 5 other repos (tests, tools, extras, CI) with corresponded docs being good to be linked to the main. Looking for ideas / advice on the best way to do that.

The main problem is that Sphinx (the documentation tool) renders files under its configuration directory only, ignoring everything outside of it so reference to external repos is not an easy task. I see several solutions:

1. The main doc points to external files (*.rst) as an external link without rendering it. Like this. ß Simplest way.
2. Create Sphinx doc for each repository, store rendered output in a temporal storage and link the main to generated HTML files.
3. Use intersphinx to link across repositories. Again, need rendered docs in each repo and additional preparation.
4. Anything else?

Any thoughts or experience to share?

Thanks in advance,

Anton