Generate the clusters data from the Google Doc, with no hand edits

.github/workflows/README.md

@@ -84,6 +84,13 @@ Triggers `deploy.yaml` after successful processing via `repository_dispatch`.
 
 
 
+### [cluster-tests.yaml](cluster-tests.yaml)
+**Clusters parser regression tests and stated sub-cluster counts**
+
+| Trigger | Runs on |
+|---------|---------|
+| Pull requests changing the clusters data, parser or tests | PR branches |
+
 ### [check_images.yaml](workflows/check_images.yaml)
 **Image validation in PRs**
 

.github/workflows/cluster-tests.yaml

@@ -0,0 +1,30 @@
+name: Cluster Tests
+
+# =======================
+# Clusters data checks
+# =======================
+# Purpose: Runs the parser regression tests and checks the stated sub-cluster counts
+# Triggers: PRs that change the clusters data, its parser or these tests
+
+on:
+  pull_request:
+    paths:
+      - 'data/clusters_v4.json'
+      - 'scripts/parse_clusters_to_sheet.py'
+      - 'scripts/tests/test_clusters_data.py'
+      - 'scripts/tests/test_parse_clusters.py'
+      - '.github/workflows/cluster-tests.yaml'
+
+permissions:
+  contents: read
+
+jobs:
+  cluster-tests:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Run cluster tests
+        run: python3 -m unittest discover -s scripts/tests -p 'test_*clusters*.py'

CONTRIBUTING.md

@@ -153,6 +153,8 @@ If a contribution amounts to running a single prompt, please consider posting th
 
 ### Content, Licensing & Fact-Checking
 
+**Generated content:** `data/clusters_v4.json` and `content/clusters/cluster-N/index.md` are generated, so never edit them by hand. Correct the [Clusters v4.1 Google Doc](https://docs.google.com/document/d/1_TRh7z3Bv_tdxGqjdWMm4kfQerTYvYw3e4wvQLNpTDQ/edit), then run `python3 scripts/parse_clusters_to_sheet.py --json-only` and `python3 scripts/generate_cluster_pages.py`.
+
 - Please **fact-check** anything you add and cite sources where relevant, so the site stays accurate and trustworthy.
 - The repository is distributed under [CC BY-NC-SA 4.0](LICENSE.md). Make sure you have the right to contribute the material and retain attribution and source licence notices.
 - Under the existing contribution policy, unless you tell us otherwise, contributions are assumed to be offered under [**CC BY 4.0**](https://creativecommons.org/licenses/by/4.0/).

content/clusters/cluster-10/index.md

@@ -4,10 +4,10 @@ layout = "cluster"
 cluster_number = 10
 title = "Cluster 10: Qualitative Research — FORRT Open Science Taxonomy"
 heading_title = "Cluster 10: Qualitative Research"
-summary = "FORRT Cluster 10: Qualitative Research. Invite review of: Qualitative Open Science OS Booklet.pdf Description Qualitative research refers to research conducted with non-numeric data, such as interviews, focus groups, ethnographies, photovoice, and others. There are 10 sub-clusters that can help read"
-description = "FORRT Cluster 10: Qualitative Research. Invite review of: Qualitative Open Science OS Booklet.pdf Description Qualitative research refers to research conducted with non-numeric data, such as interviews, focus groups, ethnographies, photovoice, and others. There are 10 sub-clusters that can help read"
+summary = "FORRT Cluster 10: Qualitative Research. Qualitative research refers to research conducted with non-numeric data, such as interviews, focus groups, ethnographies, photovoice, and others. There are 10 sub-clusters that can help readers understand open science from a qualitative perspective:"
+description = "FORRT Cluster 10: Qualitative Research. Qualitative research refers to research conducted with non-numeric data, such as interviews, focus groups, ethnographies, photovoice, and others. There are 10 sub-clusters that can help readers understand open science from a qualitative perspective:"
 sharing_title = "Cluster 10: Qualitative Research — FORRT Open Science Taxonomy"
-sharing_description = "FORRT Cluster 10: Qualitative Research. Invite review of: Qualitative Open Science OS Booklet.pdf Description Qualitative research refers to research conducted with non-numeric data, such as interviews, focus groups, ethnographies, photovoice, and others. There are 10 sub-clusters that can help read"
+sharing_description = "FORRT Cluster 10: Qualitative Research. Qualitative research refers to research conducted with non-numeric data, such as interviews, focus groups, ethnographies, photovoice, and others. There are 10 sub-clusters that can help readers understand open science from a qualitative perspective:"
 
 keywords = [ "FORRT cluster 10", "open science", "reproducible research", "Qualitative Research" ]
 

content/clusters/cluster-2/index.md

@@ -4,10 +4,10 @@ layout = "cluster"
 cluster_number = 2
 title = "Cluster 2: Conceptual and Statistical Knowledge — FORRT Open Science Taxonomy"
 heading_title = "Cluster 2: Conceptual and Statistical Knowledge"
-summary = "FORRT Cluster 2: Conceptual and Statistical Knowledge. Attainment of a grounding in fundamental statistics, measurement, and its implications encompassing conceptual knowledge, application, interpretation and communication of statistical analyses. There are 8 sub-clusters which aim to further par…"
-description = "FORRT Cluster 2: Conceptual and Statistical Knowledge. Attainment of a grounding in fundamental statistics, measurement, and its implications encompassing conceptual knowledge, application, interpretation and communication of statistical analyses. There are 8 sub-clusters which aim to further par…"
+summary = "FORRT Cluster 2: Conceptual and Statistical Knowledge. Attainment of a grounding in fundamental statistics, measurement, and its implications encompassing conceptual knowledge, application, interpretation and communication of statistical analyses. There are 7 sub-clusters which aim to further par…"
+description = "FORRT Cluster 2: Conceptual and Statistical Knowledge. Attainment of a grounding in fundamental statistics, measurement, and its implications encompassing conceptual knowledge, application, interpretation and communication of statistical analyses. There are 7 sub-clusters which aim to further par…"
 sharing_title = "Cluster 2: Conceptual and Statistical Knowledge — FORRT Open Science Taxonomy"
-sharing_description = "FORRT Cluster 2: Conceptual and Statistical Knowledge. Attainment of a grounding in fundamental statistics, measurement, and its implications encompassing conceptual knowledge, application, interpretation and communication of statistical analyses. There are 8 sub-clusters which aim to further par…"
+sharing_description = "FORRT Cluster 2: Conceptual and Statistical Knowledge. Attainment of a grounding in fundamental statistics, measurement, and its implications encompassing conceptual knowledge, application, interpretation and communication of statistical analyses. There are 7 sub-clusters which aim to further par…"
 
 keywords = [ "FORRT cluster 2", "open science", "reproducible research", "Conceptual and Statistical Knowledge" ]