Tweaks to get linting working (#63)

* Additional tweaks to fix deployment

* Fix internal linking

* Enable check-internal-hash

* Tweaks

.github/workflows/check-links.yml

@@ -2,9 +2,12 @@ name: Check for broken links
 
 on:
   workflow_dispatch:
-  pull_request:
-    paths:
-      - "source/**"
+#  push:
+#    branches:
+#      - "more-updates"
+#  pull_request:
+#    paths:
+#      - "source/**"
 
 jobs:
   check_links:

.github/workflows/publish.yml

@@ -63,5 +63,4 @@ jobs:
         cd github-pages
         tar -xvf artifact.tar
         npm install linkinator
-        npx linkinator . --recurse --markdown \
-        #  --skip https://github.com/ministryofjustice/some-private-repo \
+        npx linkinator . --recurse --markdown --skip '\-deploy$'

config/tech-docs.yml

@@ -4,7 +4,7 @@ host: https://ministryofjustice.github.io/moj-forms-tech-docs
 # Header-related options
 show_govuk_logo: true
 service_name: MOJ Forms Tech Docs
-service_link: /moj-forms-tech-docs
+service_link: '#moj-forms-tech-docs'
 
 # Links to show on right-hand-side of header
 header_links:

makefile

@@ -1,4 +1,4 @@
-IMAGE := ministryofjustice/tech-docs-github-pages-publisher:1.3
+IMAGE := ministryofjustice/tech-docs-github-pages-publisher:v3.0.2
 
 # Use this to run a local instance of the documentation site, while editing
 .PHONY: preview
@@ -7,4 +7,4 @@ preview:
 		-v $$(pwd)/config:/app/config \
 		-v $$(pwd)/source:/app/source \
 		-p 4567:4567 \
-		-it $(IMAGE) /publishing-scripts/preview.sh
+		-it $(IMAGE) /scripts/preview.sh

source/documentation/adr/ADR-001-record-architecture-decisions.html.md.erb

@@ -27,7 +27,7 @@ We need to record the architectural decisions made on this project.
 
 ## Decision
 
-We will use Architecture Decision Records, as [described by Michael Nygard](http://thinkrelevance.com/blog/2011/11/15/documenting-architecture-decisions).
+We will use Architecture Decision Records, as [described by Michael Nygard](https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions).
 
 ## Consequences