diff --git a/docs/src/developers_guide/contributing_getting_involved.rst b/docs/src/developers_guide/contributing_getting_involved.rst index 9ec6559114..6ade098b6b 100644 --- a/docs/src/developers_guide/contributing_getting_involved.rst +++ b/docs/src/developers_guide/contributing_getting_involved.rst @@ -61,6 +61,5 @@ If you are new to using GitHub we recommend reading the ../generated/api/iris ../whatsnew/index - ../techpapers/index ../copyright ../voted_issues diff --git a/docs/src/further_topics/index.rst b/docs/src/further_topics/index.rst new file mode 100644 index 0000000000..90dbfb2ced --- /dev/null +++ b/docs/src/further_topics/index.rst @@ -0,0 +1,20 @@ +.. _further_topics_index: + + +Further Topics +=============== + +Extra information on specific technical issues. + +.. toctree:: + :maxdepth: 1 + + filtering_warnings + metadata + lenient_metadata + lenient_maths + um_files_loading + missing_data_handling + netcdf_io + dask_best_practices/index + ugrid/index diff --git a/docs/src/techpapers/missing_data_handling.rst b/docs/src/further_topics/missing_data_handling.rst similarity index 100% rename from docs/src/techpapers/missing_data_handling.rst rename to docs/src/further_topics/missing_data_handling.rst diff --git a/docs/src/techpapers/netcdf_io.rst b/docs/src/further_topics/netcdf_io.rst similarity index 100% rename from docs/src/techpapers/netcdf_io.rst rename to docs/src/further_topics/netcdf_io.rst diff --git a/docs/src/techpapers/um_files_loading.rst b/docs/src/further_topics/um_files_loading.rst similarity index 100% rename from docs/src/techpapers/um_files_loading.rst rename to docs/src/further_topics/um_files_loading.rst index f94898b3aa..9d9393f16d 100644 --- a/docs/src/techpapers/um_files_loading.rst +++ b/docs/src/further_topics/um_files_loading.rst @@ -1,5 +1,3 @@ -.. _um_files_loading: - .. testsetup:: import numpy as np @@ -13,6 +11,8 @@ np.set_printoptions(precision=8) +.. _um_files_loading: + =================================== Iris Handling of PP and Fieldsfiles =================================== diff --git a/docs/src/index.rst b/docs/src/index.rst index b353406f58..ab6730f684 100644 --- a/docs/src/index.rst +++ b/docs/src/index.rst @@ -203,4 +203,12 @@ The legacy support resources: Iris API +.. toctree:: + :caption: Further Topics + :maxdepth: 1 + :hidden: + + Further Topics + + .. todolist:: diff --git a/docs/src/techpapers/index.rst b/docs/src/techpapers/index.rst deleted file mode 100644 index e97a87f39c..0000000000 --- a/docs/src/techpapers/index.rst +++ /dev/null @@ -1,14 +0,0 @@ -.. _techpapers_index: - - -Iris Technical Papers -===================== - -Extra information on specific technical issues. - -.. toctree:: - :maxdepth: 1 - - um_files_loading.rst - missing_data_handling.rst - netcdf_io.rst diff --git a/docs/src/userguide/index.rst b/docs/src/userguide/index.rst index c87323da8e..20d4ec3cd1 100644 --- a/docs/src/userguide/index.rst +++ b/docs/src/userguide/index.rst @@ -20,7 +20,7 @@ they may serve as a useful reference for future exploration. .. toctree:: - :maxdepth: 2 + :maxdepth: 1 iris_cubes loading_iris_cubes @@ -37,14 +37,3 @@ they may serve as a useful reference for future exploration. code_maintenance glossary - -.. toctree:: - :maxdepth: 2 - :caption: Further Topics - - ../further_topics/filtering_warnings - ../further_topics/metadata - ../further_topics/lenient_metadata - ../further_topics/lenient_maths - ../further_topics/dask_best_practices/index - ../further_topics/ugrid/index diff --git a/docs/src/whatsnew/1.7.rst b/docs/src/whatsnew/1.7.rst index 1d7c7c3f60..4c3f3197dc 100644 --- a/docs/src/whatsnew/1.7.rst +++ b/docs/src/whatsnew/1.7.rst @@ -329,6 +329,6 @@ Documentation * A clarification of the behaviour of :func:`iris.analysis.calculus.differentiate`. -* A new :doc:`"Technical Papers" ` section has been added to +* A new Technical Papers section has been added to the documentation along with the addition of a paper providing an - :doc:`overview of the load process for UM-like fileformats (e.g. PP and Fieldsfile) `. + :ref:`overview of the load process for UM-like fileformats (e.g. PP and Fieldsfile) `. diff --git a/docs/src/whatsnew/latest.rst b/docs/src/whatsnew/latest.rst index 3f2f9a1fd9..4423924188 100644 --- a/docs/src/whatsnew/latest.rst +++ b/docs/src/whatsnew/latest.rst @@ -126,6 +126,9 @@ This document explains the changes made to Iris for this release saving and loading, :ref:`netcdf_io` with a section on chunking, and placeholders for further topics. (:pull:`5588`) +#. `@Esadek-MO`_ moved :ref:`further_topics_index` onto it's own page, and moved + all the technical papers into this new page. (:pull:`5604`) + 💼 Internal ===========