fix(doc): enable working quartodoc.sections

_quarto.yml

@@ -61,16 +61,16 @@ website:
           - "python/README.md"
           - section: "Reference"
             contents:
-              - href: "docs/reference/data_download.ceda_ftp_download.download_ftp.qmd"
+              - href: "docs/reference/ceda_ftp_download.download_ftp.qmd"
                 text: "Download CEDA FTP"
+              - href: "docs/reference/utils.qmd"
+                text: "Utilities"
               # There are errors rendering the pages below
               # see: https://github.com/alan-turing-institute/clim-recal/issues/128
               # - href: "docs/reference/resampling.qmd"
               #   text: "HADs Resampling"
               # - href: "docs/reference/debiasing.qmd"
               #   text: "Debiasing"
-              - href: "docs/reference/utils.qmd"
-                text: "Utilities"
       - text: "Docker"
         href: "docs/docker-configurations.qmd"
 
@@ -83,16 +83,18 @@ quartodoc:
   # write sidebar data to this file
   sidebar: _sidebar.yml
   source_dir: ./python/
-  #
   # see: https://github.com/alan-turing-institute/clim-recal/issues/128
-  # sections:
-  #   - title: Data Source Management
-  #     desc: How data is downloaded for use
-  #     contents:
-  #       # the functions being documented in the package.
-  #       # you can refer to anything: class methods, modules, etc..
-  #       - data_download
-  #       # - load_data
-  #       # - resampling
-  #       # - debiasing
-  #       - utils
+  sections:
+    - title: Data Source Management
+      desc: How data is downloaded for use
+      contents:
+        # the functions being documented in the package.
+        # you can refer to anything: class methods, modules, etc..
+        - data_download
+        # - load_data
+        # - resampling
+        # - debiasing
+    - title: Utilities
+      desc: Manage data and workshops
+      contents:
+        - utils