From 64ac026e0da146a6a6499ba4a4d4842a7a9494bb Mon Sep 17 00:00:00 2001 From: Jaapio Date: Mon, 18 Nov 2024 22:50:47 +0100 Subject: [PATCH] [TASK] Improve note about automated migration --- Documentation/Howto/Migration/Index.rst | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/Documentation/Howto/Migration/Index.rst b/Documentation/Howto/Migration/Index.rst index 96b7eaa..30a384f 100644 --- a/Documentation/Howto/Migration/Index.rst +++ b/Documentation/Howto/Migration/Index.rst @@ -12,9 +12,12 @@ Migration: From Sphinx to PHP-based rendering .. note:: - Since the beginning of 2024 you can switch to the new, PHP-based reStructured - Text rendering to try it out. The new rendering will become mandatory in - August 2024. + Since November 2024 the official documentation rendering process has been + switched to a PHP-based rendering. When your documentation was configured + with Sphinx, the rendering process will be automatically switched to the + PHP-based rendering. The automatic migration will work for most cases, but + some manual adjustments might be necessary. This guide will help you to + migrate your documentation to the new rendering process. The main difference compared to the Sphinx rendering is that the PHP-based rendering requires a file called :file:`Documentation/guides.xml` for configuration.