From 9f7abbdf47d05e722dd3dcbb0577fe98879250cf Mon Sep 17 00:00:00 2001 From: jennyhickson Date: Wed, 16 Jul 2025 17:57:41 +0100 Subject: [PATCH 1/2] update home page with links --- source/Development/TestSuites/multi-repo_testing.rst | 4 ++-- source/WorkingPractices/multi_repository.rst | 4 ++-- source/index.rst | 11 +++++++++-- 3 files changed, 13 insertions(+), 6 deletions(-) diff --git a/source/Development/TestSuites/multi-repo_testing.rst b/source/Development/TestSuites/multi-repo_testing.rst index 181d84ca..e921d3ea 100644 --- a/source/Development/TestSuites/multi-repo_testing.rst +++ b/source/Development/TestSuites/multi-repo_testing.rst @@ -27,7 +27,7 @@ To test the UM, any changes to JULES, UKCA, Socrates, CASIM etc will also need to be included. This is done by adding another source to the rose stem command line. -1. :ref:`Checkout` a UM working copy +1. Checkout` a UM working copy - this may be your branch from a linked ticket, or a clean trunk copy at either the last release or a suitable head of trunk revision. @@ -50,7 +50,7 @@ Paths to the other codebases involved should be added to ``dependencies.sh`` under each of the ``*_sources`` variables. Again these paths can either be to local changes or those in the repository. -1. :ref:`Checkout` an LFRic Apps working copy +1. Checkout an LFRic Apps working copy - this may be your branch from a linked ticket, or a clean trunk copy at either the last release or a suitable head of trunk revision. diff --git a/source/WorkingPractices/multi_repository.rst b/source/WorkingPractices/multi_repository.rst index 5dfe23c0..9e2847af 100644 --- a/source/WorkingPractices/multi_repository.rst +++ b/source/WorkingPractices/multi_repository.rst @@ -33,12 +33,12 @@ will need testing with both the UM and LFRic Apps to check for any interactions. Preparing Linked Tickets ------------------------ Every repository in a set of linked changes requires a ticket. Guidance on -setting these up can be found in :ref:`ticket`. These tickets will be treated +setting these up can be found in ticket. These tickets will be treated as a group with the same reviewers and committed at the same time. Do: * Make sure every ticket has a cross reference to the others in the set, e.g. ``um:#1234`` - * Use :ref:`keywords` to show which other repositories are involved + * Use keywords to show which other repositories are involved * Get the tickets ready for review at the same time * Ask for help testing if you don't have access to all the codebases involved diff --git a/source/index.rst b/source/index.rst index 3cf5b562..80319836 100644 --- a/source/index.rst +++ b/source/index.rst @@ -9,7 +9,10 @@ Simulation Systems Working Practices ==================================== **These pages describe the working practices of the following simulation and -model codes owned by the Met Office; UM, LFRic Applications, JULES and UKCA.** +model codes owned by the Met Office:** `LFRic Applications `_, +`LFRic Core `_ `UM `_, +`JULES `_, `SOCRATES `_, +`CASIM `_ and `UKCA `_. This includes how to get started, key points on developing your change and how to test those developments. There is guidance on making changes that span multiple @@ -111,4 +114,8 @@ and how to commit to the trunk. :hidden: :caption: Further Details - FurtherDetails/index \ No newline at end of file + FurtherDetails/index + + +More detailed, project specific, documentation is also available. See the wiki pages in each repository as well as +the :ref:`docs` page for more information on what is available and how to contribute to it. From afc07abe135a3017f00066852e23607d88722c58 Mon Sep 17 00:00:00 2001 From: jennyhickson Date: Wed, 16 Jul 2025 18:04:59 +0100 Subject: [PATCH 2/2] move links --- source/index.rst | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/source/index.rst b/source/index.rst index 80319836..cab76d02 100644 --- a/source/index.rst +++ b/source/index.rst @@ -9,10 +9,8 @@ Simulation Systems Working Practices ==================================== **These pages describe the working practices of the following simulation and -model codes owned by the Met Office:** `LFRic Applications `_, -`LFRic Core `_ `UM `_, -`JULES `_, `SOCRATES `_, -`CASIM `_ and `UKCA `_. +model codes owned by the Met Office:** `LFRic Applications`_, `LFRic Core`_, `UM`_, `JULES`_, `SOCRATES`_, +`CASIM`_ and `UKCA`_. This includes how to get started, key points on developing your change and how to test those developments. There is guidance on making changes that span multiple @@ -119,3 +117,11 @@ and how to commit to the trunk. More detailed, project specific, documentation is also available. See the wiki pages in each repository as well as the :ref:`docs` page for more information on what is available and how to contribute to it. + +.. _LFRic Applications: https://github.com/MetOffice/lfric_apps +.. _LFRic Core: https://github.com/MetOffice/lfric_core +.. _UM: https://github.com/MetOffice/um +.. _CASIM: https://github.com/MetOffice/casim +.. _JULES: https://github.com/MetOffice/jules +.. _SOCRATES: https://github.com/MetOffice/socrates +.. _UKCA: https://github.com/MetOffice/ukca