chore: added how-to placeholders

_quarto.yml

@@ -26,6 +26,8 @@ website:
         text: Getting Started
       - href: docs/explanation/index.qmd
         text: Explanation
+      - href: docs/how_to/index.qmd
+        text: How-To
       - href: docs/tutorials/index.qmd
         text: Tutorials
       - href: docs/reference/index.qmd
@@ -50,6 +52,10 @@ website:
           - "docs/explanation/what_is_tp/index.qmd"
           - "docs/explanation/calculate_tp/index.qmd"
           - "docs/explanation/limitations/index.qmd"
+      - section: How-To
+        href: docs/how_to/index.qmd
+        contents:
+          - auto: "docs/how_to/**/*.qmd"
       - section: Tutorials
         href: docs/tutorials/index.qmd
         contents:

docs/how_to/gtfs/index.qmd

@@ -0,0 +1,10 @@
+---
+title: "Get Public Transit Schedule Data (GTFS)"
+description: Instructions on retrieving public transit schedule GTFS data.
+date-modified: 05/16/2024  # must be in MM/DD/YYYY format
+categories: ["How-To"]  # see https://diataxis.fr/tutorials-how-to/#tutorials-how-to, delete as appropriate
+toc: true
+date-format: iso
+---
+
+🚧 Page under construction 🚧

docs/how_to/index.qmd

@@ -0,0 +1,13 @@
+---
+title: How-To
+listing:
+    type: table
+    contents:
+        - "/**/*.qmd"
+    fields: [title, description, reading-time]
+    sort: title desc
+    sort-ui: true
+    filter-ui: true
+---
+
+These pages are short step-by-step instructions on how-to get something done, in particular retrieve the required input data for `transport_performance`.

docs/how_to/osm/index.qmd

@@ -0,0 +1,10 @@
+---
+title: "Get OpenStreetMap Data"
+description: Instructions on retrieving OpenStreetMap data.
+date-modified: 05/16/2024  # must be in MM/DD/YYYY format
+categories: ["How-To"]  # see https://diataxis.fr/tutorials-how-to/#tutorials-how-to, delete as appropriate
+toc: true
+date-format: iso
+---
+
+🚧 Page under construction 🚧

docs/how_to/uc_pop/index.qmd

@@ -0,0 +1,10 @@
+---
+title: "Get Gridded Population Estimates"
+description: Instructions on retrieving gridded population estimates for calculating urban centres and population distributions.
+date-modified: 05/16/2024  # must be in MM/DD/YYYY format
+categories: ["How-To"]  # see https://diataxis.fr/tutorials-how-to/#tutorials-how-to, delete as appropriate
+toc: true
+date-format: iso
+---
+
+🚧 Page under construction 🚧