Skip to content

Commit cd0fe13

Browse files
committed
expanded 7 upgrade instructions a little.
1 parent 666800d commit cd0fe13

File tree

1 file changed

+10
-4
lines changed

1 file changed

+10
-4
lines changed

src/7-to-8/summary.rst

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -38,10 +38,16 @@ Upgrading To Cylc 8
3838
* Major Changes: :ref:`cylc_7_compat_mode`
3939

4040
There have been some configuration changes at Cylc 8.
41-
To upgrade your Cylc 7 suite to a Cylc 8 workflow, first make sure it validates
42-
in Cylc 7 without any warnings, then rename the workflow configuration file
43-
from ``suite.rc`` to ``flow.cylc``, then run ``cylc validate`` in Cylc 8 and
44-
take action on any warnings.
41+
To upgrade your Cylc 7 suite to a Cylc 8 workflow:
42+
43+
#. Using Cylc 7, make sure the configuration validates (``cylc validate``)
44+
without any warnings.
45+
#. Using Cylc 8 check that you can run the workflow. Running Cylc 8 with a
46+
workflow configured with a ``suite.rc`` turns on
47+
:ref:`compatibility mode <cylc_7_compat_mode>`.
48+
#. Rename the workflow configuration file from ``suite.rc`` to ``flow.cylc``.
49+
#. Using Cylc 8 run ``cylc lint --ruleset 728`` and ``cylc validate``. Make
50+
sure that you deal with any warnings produced by these scripts.
4551

4652
.. TODO Add ref to breaking changes section within Major changes, once created,
4753
including optional ouputs.

0 commit comments

Comments
 (0)