Merge pull request #861 from sphinx-contrib/doc-note-for-downgrading-…

…page-editor-version doc: provide hint on editor change needing a page delete
sphinx-contrib · Nov 19, 2023 · d924ffc · d924ffc
2 parents 7233db3 + c032174
commit d924ffc
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/doc/configuration.rst b/doc/configuration.rst
@@ -283,6 +283,10 @@ Generic configuration
           in editors by inspecting the `online demo`_.
         - Using the ``v2`` editor with Confluence server may yield unexpected
           results.
+        - If a page is published with a ``v2`` editor, an attempt to re-publish
+          with a ``v1`` editor style may be ignored in Confluence Cloud. In
+          such situations, users are recommended to delete the pages on
+          Confluence and then retry the publish attempt with this extension.
 
     A string value to indicate which `Confluence editor`_ to target. The
     following editor values are supported: