From 20f393bfd217330aeb72d60f9036345cdbf63060 Mon Sep 17 00:00:00 2001
From: Ross Buggins <ross.buggins@nhs.net>
Date: Wed, 22 May 2024 14:33:23 +0100
Subject: [PATCH 1/2] added make docs.

---
 docs/index.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/docs/index.md b/docs/index.md
index 55279eb..c1e9873 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -45,6 +45,8 @@ NHS Notify - for the NHS Notify web site, onboarding guidance, and customer supp
 - [Table of Contents](#table-of-contents)
 - [Documentation](#documentation)
 - [Setup](#setup)
+  - [Prerequisites](#prerequisites)
+  - [Configuration](#configuration)
 - [Contributing](#contributing)
 - [Licence](#licence)
 
@@ -63,6 +65,34 @@ cd nhs-notify
 code project.code-workspace
 ```
 
+### Prerequisites
+
+The following software packages, or their equivalents, are expected to be installed and configured:
+
+- [Docker](https://www.docker.com/) container runtime or a compatible tool, e.g. [Podman](https://podman.io/),
+- [asdf](https://asdf-vm.com/) version manager,
+- [GNU make](https://www.gnu.org/software/make/) 3.82 or later,
+- [GNU coreutils](https://www.gnu.org/software/coreutils/) and [GNU binutils](https://www.gnu.org/software/binutils/) may be required to build dependencies like Python, which may need to be compiled during installation. For macOS users, this has been scripted and automated by the `dotfiles` project; please see this [script](https://github.com/nhs-england-tools/dotfiles/blob/main/assets/20-install-base-packages.macos.sh) for details,
+- [Python](https://www.python.org/) required to run Git hooks,
+- [`jq`](https://jqlang.github.io/jq/) a lightweight and flexible command-line JSON processor.
+
+> [!NOTE]<br>
+> The version of GNU make available by default on macOS is earlier than 3.82. You will need to upgrade it or certain `make` tasks will fail. On macOS, you will need [Homebrew](https://brew.sh/) installed, then to install `make`, like so:
+>
+> ```shell
+> brew install make
+> ```
+>
+> You will then see instructions to fix your `$PATH` variable to make the newly installed version available. If you are using [dotfiles](https://github.com/nhs-england-tools/dotfiles), this is all done for you.
+
+### Configuration
+
+Installation and configuration of the toolchain dependencies (including pre git hooks).
+
+```shell
+make config
+```
+
 ## Contributing
 
 Describe or link templates on how to raise an issue, feature request or make a contribution to the codebase. Reference the other documentation files, like

From e76e73ace5fb58b0b20ec96dea7367f84d35e1ce Mon Sep 17 00:00:00 2001
From: Ross Buggins <ross.buggins@nhs.net>
Date: Wed, 22 May 2024 14:48:47 +0100
Subject: [PATCH 2/2] header size.

---
 docs/_config.yml                  | 2 +-
 docs/_sass/color_schemes/nhs.scss | 2 ++
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/_config.yml b/docs/_config.yml
index 75a7561..5f0ea7b 100644
--- a/docs/_config.yml
+++ b/docs/_config.yml
@@ -18,7 +18,7 @@
 # You can create any custom variable you would like, and they will be accessible
 # in the templates via {{ site.myvariable }}.
 
-title: NHS Notify
+title: NHS Notify Tech Docs
 # email: your-email@example.com
 description: >- # this means to ignore newlines until "baseurl:"
   Write an awesome description for your new site here. You can edit this
diff --git a/docs/_sass/color_schemes/nhs.scss b/docs/_sass/color_schemes/nhs.scss
index 3ecdc4c..5b45b8f 100644
--- a/docs/_sass/color_schemes/nhs.scss
+++ b/docs/_sass/color_schemes/nhs.scss
@@ -14,3 +14,5 @@ $grey-dk-100: #f0f4f5;
 $sidebar-color: $grey-dk-000;
 $body-background-color: $grey-dk-100;
 $link-color: $blue-000;
+
+$font-size-7: 1.25rem;