From ab6ad42159286717d557c7df8398a8ca1eb88836 Mon Sep 17 00:00:00 2001 From: Sarah McCarthy Date: Tue, 30 Jun 2026 15:39:15 +0200 Subject: [PATCH] [TASK] Add note about removing 1st line of guides.xml file. This first line currently leads to problems during intercept rendering of extension documentation Releases:main --- Documentation/Howto/WritingDocForExtension/Index.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Documentation/Howto/WritingDocForExtension/Index.rst b/Documentation/Howto/WritingDocForExtension/Index.rst index e49871da..f7950487 100644 --- a/Documentation/Howto/WritingDocForExtension/Index.rst +++ b/Documentation/Howto/WritingDocForExtension/Index.rst @@ -44,6 +44,11 @@ Follow the interactive dialog. We suggest to use the option ReStructuredText (rs as this format provides the full power of the TYPO3 documentation theme. Using Markdown (md) is an option for simple and quick one page documentation. +.. note:: + The first line of the guides.xml file can lead to rendering problems on the + server, so it is best to delete it. The file should start with a ``_ enter its name and path when prompted. This will regenerate ready to use documentation about configuration for you. If you have more then one set you