federated-research · AndrewThien · Jul 31, 2026 · Jul 28, 2026 · Jul 29, 2026 · Jul 29, 2026
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
@@ -0,0 +1,37 @@
+# Description
+
+<!-- Describe what's in this PR / what it does -->
+
+
+## Review checks
+
+<!-- No author action required beyond this point -->
+
+### Metadata
+
+#### Frontmatter
+- [ ] `<DocMetadata />` component at top of document
+- [ ] `docType`
+    - `journey` - A page of curated suggested documents for a persona or purpose
+    - `explanation` per [Diataxis]
+    - `tutorial` per [Diataxis]
+    - `guide` per [Diataxis]
+    - `reference` per [Diataxis]
+    - Category or splash pages do not require this
+- [ ] `readingTime` in [ISO 8601 Duration] format
+    - Only required for `explanation`, `tutorial` and `guide`
+- [ ] `audiences` - one or more target audiences for the content
+    - `federation-operator`
+    - `tre-operator`
+    - `researcher`
+    - `integrator`
+    - `contributor`
+    - `everyone`
+
+#### Content
+
+- [ ] Prerequisites, if appropriate
+- [ ] Next steps, if appropriate
+
+[diataxis]: https://diataxis.fr/
+[ISO 8601 Duration]: https://en.wikipedia.org/wiki/ISO_8601#Durations
diff --git a/app/_meta.js b/app/_meta.js
@@ -1,9 +1,17 @@
 export default {
-  connect: "Connect",
-  "co-ordinate": "Co-ordinate",
+  index: {
+    display: "hidden"
+  },
 
   // Welcome Report URL redirect, never show in nav
   five_safes_tes: {
     display: "hidden"
-  }
+  },
+
+  // exclude routes until content published
+  "journeys": {
+    display: "hidden"
+  },
+
+  // TODO: restructure content and move "connect" journey page
 };
diff --git a/app/co-ordinate/_meta.js b/app/co-ordinate/_meta.js
diff --git a/app/co-ordinate/management/page.mdx b/app/co-ordinate/management/page.mdx
diff --git a/app/co-ordinate/page.mdx b/app/co-ordinate/page.mdx
diff --git a/app/co-ordinate/setup_sub_layer/page.mdx b/app/co-ordinate/setup_sub_layer/page.mdx
diff --git a/app/connect/approvals/page.mdx b/app/connect/approvals/page.mdx
@@ -1,4 +1,5 @@
 ---
+docType: guide
 readingTime: PT10M
 audiences: tre-operator
 ---

diff --git a/app/connect/approve-outputs/page.mdx b/app/connect/approve-outputs/page.mdx
@@ -1,4 +1,5 @@
 ---
+docType: guide
 readingTime: PT5M
 audiences: tre-operator
 ---

diff --git a/app/connect/connect-submission/page.mdx b/app/connect/connect-submission/page.mdx
@@ -1,4 +1,5 @@
 ---
+docType: guide
 readingTime: PT15M
 audiences: tre-operator
 ---

diff --git a/app/connect/page.mdx b/app/connect/page.mdx
@@ -1,6 +1,11 @@
 ---
+docType: journey
 title: Connect
 asIndexPage: true
 ---
 
 # Connect
+
+import {UnderConstruction} from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/connect/setup-tre/configuration/page.mdx b/app/connect/setup-tre/configuration/page.mdx
@@ -1,4 +1,5 @@
 ---
+docType: reference
 readingTime: PT30M
 audiences: tre-operator
 ---

diff --git a/app/connect/setup-tre/deployment-steps/page.mdx b/app/connect/setup-tre/deployment-steps/page.mdx
@@ -1,4 +1,5 @@
 ---
+docType: guide
 readingTime: PT45M
 audiences: tre-operator
 ---

diff --git a/app/connect/setup-tre/page.mdx b/app/connect/setup-tre/page.mdx
@@ -1,6 +1,11 @@
 ---
+docType: journey
 title: Setup TRE Agent
 asIndexPage: true
 ---
 
 # Setup TRE Agent Journeys
+
+import {UnderConstruction} from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/connect/tes-backend/install-funnel/page.mdx b/app/connect/tes-backend/install-funnel/page.mdx
@@ -1,4 +1,5 @@
 ---
+docType: guide
 readingTime: PT45M
 audiences: tre-operator
 ---

diff --git a/app/connect/tes-backend/tes-implementations/page.mdx b/app/connect/tes-backend/tes-implementations/page.mdx
@@ -1,4 +1,5 @@
 ---
+docType: explanation
 readingTime: PT20M
 audiences: tre-operator
 ---

diff --git a/app/journeys/co-ordinate/_meta.js b/app/journeys/co-ordinate/_meta.js
@@ -0,0 +1,5 @@
+export default {
+  // exclude routes until content published
+  // setup_sub_layer: "Setup Submission Layer",
+  // management: "Management",
+};
diff --git a/app/journeys/co-ordinate/management/page.mdx b/app/journeys/co-ordinate/management/page.mdx
@@ -0,0 +1,7 @@
+---
+# TODO: move to correct structure when content added
+---
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/co-ordinate/page.mdx b/app/journeys/co-ordinate/page.mdx
@@ -0,0 +1,11 @@
+---
+docType: journey
+title: Co-ordinate
+asIndexPage: true
+---
+
+# Co-ordinate
+
+import {UnderConstruction} from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/co-ordinate/setup-submission/page.mdx b/app/journeys/co-ordinate/setup-submission/page.mdx
@@ -0,0 +1,7 @@
+---
+# TODO: move to correct structure when content added
+---
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/connect/page.mdx b/app/journeys/connect/page.mdx
@@ -0,0 +1,9 @@
+---
+docType: journey
+title: Connect
+asIndexPage: true
+---
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/connect/tre-data-access/page.mdx b/app/journeys/connect/tre-data-access/page.mdx
@@ -0,0 +1,7 @@
+---
+# TODO: move to correct structure when content added
+---
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/contribute/components-architecture/page.mdx b/app/journeys/contribute/components-architecture/page.mdx
@@ -0,0 +1,7 @@
+---
+# TODO: move to correct structure when content added
+---
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/contribute/contributing-guide/page.mdx b/app/journeys/contribute/contributing-guide/page.mdx
@@ -0,0 +1,7 @@
+---
+# TODO: move to correct structure when content added
+---
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/contribute/page.mdx b/app/journeys/contribute/page.mdx
@@ -0,0 +1,11 @@
+---
+docType: journey
+title: Contribute
+asIndexPage: true
+---
+
+# Contribute
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/contribute/setup-devenv/page.mdx b/app/journeys/contribute/setup-devenv/page.mdx
@@ -0,0 +1,7 @@
+---
+# TODO: move to correct structure when content added
+---
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/contribute/system-architecture/page.mdx b/app/journeys/contribute/system-architecture/page.mdx
@@ -0,0 +1,7 @@
+---
+# TODO: move to correct structure when content added
+---
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/integrate/egress-api-reference/page.mdx b/app/journeys/integrate/egress-api-reference/page.mdx
@@ -0,0 +1,7 @@
+---
+# TODO: move to correct structure when content added
+---
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/integrate/explore-and-test-locally/page.mdx b/app/journeys/integrate/explore-and-test-locally/page.mdx
@@ -0,0 +1,7 @@
+---
+# TODO: move to correct structure when content added
+---
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/integrate/infrastructure-architecture/page.mdx b/app/journeys/integrate/infrastructure-architecture/page.mdx
@@ -0,0 +1,7 @@
+---
+# TODO: move to correct structure when content added
+---
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/integrate/page.mdx b/app/journeys/integrate/page.mdx
@@ -0,0 +1,11 @@
+---
+docType: journey
+title: Integrate
+asIndexPage: true
+---
+
+# Integrate
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/integrate/setup-testenv/page.mdx b/app/journeys/integrate/setup-testenv/page.mdx
@@ -0,0 +1,7 @@
+---
+# TODO: move to correct structure when content added
+---
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/integrate/submission-api-reference/page.mdx b/app/journeys/integrate/submission-api-reference/page.mdx
@@ -0,0 +1,7 @@
+---
+# TODO: move to correct structure when content added
+---
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/integrate/tre-agent-api-reference/page.mdx b/app/journeys/integrate/tre-agent-api-reference/page.mdx
@@ -0,0 +1,7 @@
+---
+# TODO: move to correct structure when content added
+---
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/learn/omop/page.mdx b/app/journeys/learn/omop/page.mdx
@@ -0,0 +1,7 @@
+---
+# TODO: move to correct structure when content added
+---
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/learn/page.mdx b/app/journeys/learn/page.mdx
@@ -0,0 +1,11 @@
+---
+docType: journey
+title: Learn
+asIndexPage: true
+---
+
+# Learn
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/learn/personas/page.mdx b/app/journeys/learn/personas/page.mdx
@@ -0,0 +1,7 @@
+---
+# TODO: move to correct structure when content added
+---
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/learn/system-architecture/page.mdx b/app/journeys/learn/system-architecture/page.mdx
@@ -0,0 +1,7 @@
+---
+# TODO: move to correct structure when content added
+---
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/learn/what-is-five-safes/page.mdx b/app/journeys/learn/what-is-five-safes/page.mdx
@@ -0,0 +1,7 @@
+---
+# TODO: move to correct structure when content added
+---
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/research/analysis-examples/page.mdx b/app/journeys/research/analysis-examples/page.mdx
@@ -0,0 +1,7 @@
+---
+# TODO: move to correct structure when content added
+---
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/research/page.mdx b/app/journeys/research/page.mdx
@@ -0,0 +1,11 @@
+---
+docType: journey
+title: Research
+asIndexPage: true
+---
+
+# Research
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />
diff --git a/app/journeys/research/submitting-an-analysis/page.mdx b/app/journeys/research/submitting-an-analysis/page.mdx
@@ -0,0 +1,7 @@
+---
+# TODO: move to correct structure when content added
+---
+
+import { UnderConstruction } from "@/components/UnderConstruction";
+
+<UnderConstruction />