From 63300ebac0256c519d6ea01839a6d8b2e2a57b89 Mon Sep 17 00:00:00 2001
From: Tony Barker <4941711+tonypaulbarker@users.noreply.github.com>
Date: Tue, 9 Sep 2025 02:40:10 -0700
Subject: [PATCH 1/2] Update readme with instructions for placing blocks with
 other themes

---
 README.md | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 753b6fd..4a819d6 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,21 @@ Provides paginated navigation through pages with an overview page and
 block. A part of the LocalGovDrupal distribution, that can also be installed
 stand-alone.
 
-Content types:
+## Install process:
+
+Standard Drupal module installation process applies. But...
+
+The 2 x block configuration files are only installed if you are using the LocalGov Drupal base theme or Scarfolk theme. 
+So before installing this module, copy or edit these two files and replace "localgov_theme" with your theme name and set a region available to the theme:
+
+config/optional/block.block.localgov_guides_contents_base.yml
+config/optional/block.block.localgov_guides_prev_next_block_base.yml
+
+You can revert these changes after module installation as these files are no longer needed.
+
+Alternatively, add these two blocks from the Drupal block layout admin page.
+
+## Content types:
 
  * Overview - the top level section for each guide;
  * Page - the page that can be placed in a guide.

From ac76173341d13146c005951b94ecc8efbfb158de Mon Sep 17 00:00:00 2001
From: Tony Barker <4941711+tonypaulbarker@users.noreply.github.com>
Date: Mon, 15 Sep 2025 06:35:21 -0700
Subject: [PATCH 2/2] Add more detail to readme instructions

---
 README.md | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 4a819d6..7f595cd 100644
--- a/README.md
+++ b/README.md
@@ -9,11 +9,19 @@ stand-alone.
 Standard Drupal module installation process applies. But...
 
 The 2 x block configuration files are only installed if you are using the LocalGov Drupal base theme or Scarfolk theme. 
-So before installing this module, copy or edit these two files and replace "localgov_theme" with your theme name and set a region available to the theme:
+So before installing this module, copy these two files 
 
 config/optional/block.block.localgov_guides_contents_base.yml
 config/optional/block.block.localgov_guides_prev_next_block_base.yml
 
+and make the following changes to the copies of the files:
+
+- name the copies of the files consistently for your theme, e.g. localgov_guides_contents_mytheme.yml
+- update the id parameters, .e.g id: localgov_guides_contents_mytheme
+- replace "localgov_base" with your theme name, update the id  and set a region available to the theme:
+
+Note: if you have a long machine name for your theme, consider shortening the naming used here to avoid running into errors.
+
 You can revert these changes after module installation as these files are no longer needed.
 
 Alternatively, add these two blocks from the Drupal block layout admin page.