Note
This version of the guide covers the new PHP-based rendering of Documentation with the TYPO3 Documentation theme.
If the project you are looking at has a file Documentation/guides.xml it is using the new rendering.
Otherwise, consider to migrate the Documentation or head over to the legacy version of this guide: How to document, Sphinx based.
Orphaned pages
Usually it is desired to have each and every .rst- file appear in the menu somewhere. Sphinx will issue a warning if this isn’t the case.
Hint
If really needed, an .rst file may be tagged as :orphan: right at the beginning. This will suppress the warning.
:orphan:
Copied!