From ddd2f32114416dd543892436df1c144e2bb44b03 Mon Sep 17 00:00:00 2001
From: Ryan Brown <ryan.brown@digital.cabinet-office.gov.uk>
Date: Wed, 21 Aug 2024 11:23:42 +0100
Subject: [PATCH] Add a how to guide for how to publish content from Whitehall
 using GOV.UK Docker

This is very similar to the guide for testing finders on GOV.UK Docker, but with some of the steps removed.
---
 .../publishing-content-on-whitehall.md        | 33 +++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 docs/how-tos/publishing-content-on-whitehall.md

diff --git a/docs/how-tos/publishing-content-on-whitehall.md b/docs/how-tos/publishing-content-on-whitehall.md
new file mode 100644
index 00000000..58bb85b1
--- /dev/null
+++ b/docs/how-tos/publishing-content-on-whitehall.md
@@ -0,0 +1,33 @@
+# Publishing Content from Whitehall for Developing Government Frontend
+
+This guide explains how to use GOV.UK Docker to develop features for government frontend, and how to publish content to test your
+work with locally. The instructions below assume that you have "made" all of the relevant projects before starting.
+
+1. Start the Whitehall app: `govuk-docker up whitehall-app`
+2. Start the government-frontend app: `govuk-docker up government-frontend-app`
+3. Create a router backend for government frontend:
+   ```bash
+   curl http://router-api.dev.gov.uk/backends/government-frontend -X PUT \
+   -H 'Content-type: application/json' \
+   -d '{"backend": {"backend_url": "http://government-frontend.dev.gov.uk/"}}'
+   ```
+4. Create a router backend for frontend (this is needed to serve the root taxon created in step 7):
+   ```bash
+   curl http://router-api.dev.gov.uk/backends/frontend -X PUT \
+   -H 'Content-type: application/json' \
+   -d '{"backend": {"backend_url": "http://frontend.dev.gov.uk/"}}'
+   ```
+5. Create a router backend for collections (this is needed to serve the test taxon created in step 8):
+   ```bash
+   curl http://router-api.dev.gov.uk/backends/collections -X PUT \
+   -H 'Content-type: application/json' \
+   -d '{"backend": {"backend_url": "http://collections.dev.gov.uk/"}}'
+   ```
+7. Publish the homepage and root taxon for GOV.UK: `govuk-docker run special-route-publisher-lite rake publish_homepage`
+8. Publish a test taxon so that we can tag Whitehall content with it:
+
+   ```bash
+   govuk-docker run whitehall-app-lite rails taxonomy:populate_end_to_end_test_data
+   govuk-docker run whitehall-lite rails taxonomy:rebuild_cache
+   ```
+9. Publish a document. You should be able to access it at `http://government-frontend.dev.gov.uk/{{your_base_path_here}}`