Merge pull request #848 from oliver-sanders/deprecate-compat-mode

deprecate compatibility mode

Author: hjoliver

src/7-to-8/caveats.rst

@@ -5,14 +5,6 @@ There are a few Cylc 7 features which do not yet have direct replacements in
 Cylc 8. These features will be re-implemented in future releases.
 
 
-Cylc Flow
----------
-
-Multiple Flows
-   The new :term:`scheduler` can manage multiple flows in the workflow graph.
-   Commands and options for interacting with flows are still being refined.
-
-
 Browser Based UI
 ----------------
 
@@ -39,14 +31,6 @@ Installing Workflows
    :term:`source workflows <source directory>` in the UI.
 Rose Edit
    Rose Edit is awaiting reimplementation.
-Xtrigger Visibility
-   Xtriggers are not yet visible in the UI.
-
-   * https://github.com/cylc/cylc-ui/issues/331
-Documentation / Orientation Guide
-   Some form of documentation will be provided within the UI itself.
-
-   * https://github.com/cylc/cylc-ui/issues/155
 
 
 UI Server

src/7-to-8/major-changes/compatibility-mode.rst

@@ -3,6 +3,11 @@
 Cylc 7 Compatibility Mode
 =========================
 
+.. warning::
+
+   Cylc 7 compatibility mode will be removed in Cylc 8.7.0, please upgrade
+   any workflows with "suite.rc" files.
+
 .. admonition:: Does This Change Affect Me?
    :class: tip
 

src/7-to-8/summary.rst

@@ -30,6 +30,11 @@ workflow configurations out of the box, with
 :ref:`some caveats <compat_required_changes>`. However, to future-proof
 your workflow and take full advantage of Cylc 8 you should upgrade to Cylc 8 syntax.
 
+.. warning::
+
+   Cylc 7 compatibility mode will be removed in Cylc 8.7.0.
+
+
 Upgrading To Cylc 8
 -------------------
 .. seealso::

src/reference/changes.rst

@@ -37,6 +37,17 @@ Cylc 8.5
    :rose: `2.4 <https://github.com/metomi/rose/blob/master/CHANGES.md>`__
 
 
+Compatibility Mode
+^^^^^^^^^^^^^^^^^^
+
+:ref:`Cylc 7 compatibility mode <cylc_7_compat_mode>` has been deprecated, it
+will be removed in Cylc 8.7.0 which is expected to be released some time in the
+first half of 2026.
+
+Any workflows that are still using ``suite.rc`` files will need to be upgraded
+to ``flow.cylc`` before they are able to run with 8.7.0.
+
+
 Cylc Tui
 ^^^^^^^^