Consistently use relative links to markdown files

paulrobertlloyd · paulrobertlloyd · commit 14c8f94497c3 · 2026-03-02T11:41:32.000Z
diff --git a/app/email-templates-for-sais-and-schools/changing-consent-process-for-schools.md b/app/email-templates-for-sais-and-schools/changing-consent-process-for-schools.md
@@ -43,7 +43,7 @@ Mavis is used by school age immunisation service (SAIS) teams across England. Ma
 
 You may want to let parents and guardians know that future consent requests for school vaccinations will come directly from the NHS, not from the school.
 
-You can copy and edit this [example email template](LINK) if helpful.
+You can copy and edit this [example email template](changing-consent-process-for-parents.md) if helpful.
 
 ### Questions
 
diff --git a/app/email-templates-for-sais-and-schools/index.md b/app/email-templates-for-sais-and-schools/index.md
@@ -9,14 +9,14 @@ You do not have to use them - they’re provided as examples.
 
 ## Emails for SAIS teams to send to schools
 
-- [Request class lists from a school](class-list-request)
+- [Request class lists from a school](class-list-request.md)
   Help a school send pupil information in the right format for uploading files into Mavis
 
-- [Ask a school to check their details are up to date in Get Information about Schools (GIAS)](check-gias-request)
-- [Tell schools you’re changing the way you manage consent for vaccinations](changing-consent-process-for-schools)
+- [Ask a school to check their details are up to date in Get Information about Schools (GIAS)](check-gias-request.md)
+- [Tell schools you’re changing the way you manage consent for vaccinations](changing-consent-process-for-schools.md)
   Let schools know you’ll be using Mavis to contact parents directly for vaccination consent and explain what information they’ll need to share with you in advance
 
 ## Emails for schools to send to parents
 
-- [Tell parents about changes to how consent will be requested](changing-consent-process-for-parents)
+- [Tell parents about changes to how consent will be requested](changing-consent-process-for-parents.md)
   Let parents know that future consent requests for school vaccinations will come directly from the NHS, not the school.
diff --git a/app/file-upload-templates/index.md b/app/file-upload-templates/index.md
@@ -23,6 +23,6 @@ Select the template you need from the File upload templates menu on this page.
 
 For detailed instructions on uploading files, see the following sections of the Mavis user guide:
 
-- [Importing cohorts into Mavis](guide/importing-cohorts.md)
-- [Adding vaccination history](guide/vaccination-history.md)
-- [Importing class lists](guide/class-lists.md)
+- [Importing cohorts into Mavis](../guide/importing-cohorts.md)
+- [Adding vaccination history](../guide/vaccination-history.md)
+- [Importing class lists](../guide/class-lists.md)
diff --git a/app/guide/attendance.md b/app/guide/attendance.md
@@ -11,7 +11,7 @@ You can register children’s attendance at vaccination sessions in Mavis.
 
 If this feature is enabled for your team, you can only record vaccinations for children who are registered as attending a session.
 
-This feature can be switched off on the [Edit session page](/guide/sessions).
+This feature can be switched off on the [Edit session page](sessions.md).
 
 If you switch it off, all children with consent (and ‘safe to vaccinate’ triage outcomes, where relevant) will appear in ‘Record vaccinations’.
 
diff --git a/app/guide/class-lists.md b/app/guide/class-lists.md
@@ -38,7 +38,7 @@ In Mavis:
 7. Select **Continue**. If there are any validation issues, Mavis will not import the file. Correct the issues listed in the file and try again.
 8. Wait for the file to finish uploading.
 
-Mavis may add a missing NHS number or replace an incorrect one in your upload by searching PDS. (See [See how Mavis uses PDS to find NHS numbers](/guide/importing-cohorts#see-how-mavis-uses-pds-to-find-nhs-numbers))
+Mavis may add a missing NHS number or replace an incorrect one in your upload by searching PDS. (See [See how Mavis uses PDS to find NHS numbers](importing-cohorts.md#see-how-mavis-uses-pds-to-find-nhs-numbers))
 
 > [!NOTE]
 > If a school does not provide postcodes for every child, you can still upload the class lists. You will have to add any missing NHS numbers manually.
@@ -82,7 +82,7 @@ When importing class lists, Mavis will automatically identify if a child’s sch
 
 To review a child changing school, follow the instructions on this page of the user guide:
 
-- [Reviewing school moves](/guide/school-moves)
+- [Reviewing school moves](school-moves.md)
 
 ## Handling out-of-year-group children
 
diff --git a/app/guide/consent-responses.md b/app/guide/consent-responses.md
@@ -29,7 +29,7 @@ When a parent submits a consent response, they can also let Mavis know that a ch
 
 To review a child changing school, follow the instructions on this page of the user guide:
 
-- [Reviewing school moves](/guide/school-moves)
+- [Reviewing school moves](school-moves.md)
 
 ## Reviewing unmatched consent responses
 
@@ -76,7 +76,7 @@ In both cases, you will need to investigate the conflicting consent and resolve
 3. If you click on the child’s record and scroll down, you’ll see who has said what in their consent responses.
 4. Click on the name of the parent whose consent you want to investigate. This opens their consent response, including their contact details.
 5. Contact the parent to discuss the conflicting consent.
-6. If the parent changes their consent decision when you speak to them, add their new response to the child record manually (see [Recording a new consent response](/guide/add-or-remove-consent.md)).
+6. If the parent changes their consent decision when you speak to them, add their new response to the child record manually (see [Recording a new consent response](add-or-remove-consent.md)).
 
 ## Investigating unknown parent contact details in consent response
 
@@ -88,5 +88,5 @@ If a consent response has different contact details from those on record, Mavis
 
 If the original parent informs you that the consent response came from somebody without parental responsibility, you need to:
 
-- mark the consent response as invalid (see [Marking a consent response as invalid](/guide/add-or-remove-consent.md))
-- remove the parent who sent the invalid response from the child record ([see Manually editing individual child records](/guide/editing-cohorts.md))
+- mark the consent response as invalid (see [Marking a consent response as invalid](add-or-remove-consent.md))
+- remove the parent who sent the invalid response from the child record ([see Manually editing individual child records](editing-cohorts.md))
diff --git a/app/guide/enabling-psds.md b/app/guide/enabling-psds.md
@@ -14,4 +14,4 @@ If your team uses patient specific directions (PSDs) for flu vaccinations, you c
 
 ![Screenshot of session delegation settings.](/assets/images/enable-psd.png)
 
-Any user can turn this feature on for a session. Once it’s enabled, users with a prescriber role can add PSDs to named children (see [Reviewing and adding PSDs](/guide/reviewing-and-adding-psds/)).
+Any user can turn this feature on for a session. Once it’s enabled, users with a prescriber role can add PSDs to named children (see [Reviewing and adding PSDs](reviewing-and-adding-psds.md)).
diff --git a/app/guide/importing-cohorts.md b/app/guide/importing-cohorts.md
@@ -54,7 +54,7 @@ The template below shows what other information can be imported into Mavis for c
   href: "/files/cohort-upload-template.xlsx"
 }) }}
 
-If you haven’t included a child’s NHS number, we’ll retrieve it from the Personal Demographics Service (PDS) - Mavis [automatically searches PDS](/guide/importing-cohorts#see-how-mavis-uses-pds-to-find-nhs-numbers). to find a match for the child, using the information you’ve provided (their date of birth must be correct for this to work).
+If you haven’t included a child’s NHS number, we’ll retrieve it from the Personal Demographics Service (PDS) - Mavis [automatically searches PDS](importing-cohorts.md#see-how-mavis-uses-pds-to-find-nhs-numbers). to find a match for the child, using the information you’ve provided (their date of birth must be correct for this to work).
 
 ### Preparing files for upload
 
diff --git a/app/guide/manage-consent-reminders.md b/app/guide/manage-consent-reminders.md
@@ -6,7 +6,7 @@ order: 14
 
 Mavis sends email and text reminders to parents who have not responded to the initial consent request.
 
-Automatic reminders are sent 1 week before a session takes place. You can change this on the Edit session page (see [Scheduling and editing sessions](/guide/sessions.md)).
+Automatic reminders are sent 1 week before a session takes place. You can change this on the Edit session page (see [Scheduling and editing sessions](sessions.md)).
 
 You can also send reminders manually. Mavis will then skip the next automatic reminder if it's due to be sent within 3 days.
 
diff --git a/app/guide/managing-schools.md b/app/guide/managing-schools.md
@@ -16,7 +16,7 @@ You can do this through the link in your **Getting ready to use Mavis** email or
 
 If you need to add or remove a school, [contact the Mavis team](mailto:england.mavis@nhs.net).
 
-You can update children's schools on their record. See [Editing individual child records](/guide/editing-cohorts.md).
+You can update children's schools on their record. See [Editing individual child records](editing-cohorts.md).
 
 ## Adding school sites
 
diff --git a/app/guide/notices.md b/app/guide/notices.md
@@ -8,7 +8,7 @@ eleventyComputed:
 ---
 
 > [!NOTE]
-> Only [superusers](/guide/users/#superusers) can view important notices.
+> Only [superusers](users.md#superusers) can view important notices.
 
 Whenever you log in to Mavis, you should go to **Import** and then **Important Notices** to see if there’s anything you need to be aware of. These notices will also be flagged on the Mavis dashboard.
 
diff --git a/app/guide/preparing-new-school-year.md b/app/guide/preparing-new-school-year.md
@@ -17,9 +17,9 @@ From 1 August you can:
 
 - import new cohorts that were not already in Mavis - you only need to import the new cohort, all the others are already in Mavis (when you upload a cohort or class list, make sure the YEAR_GROUP column in the CSV file shows the school year the child will be in from 1 September)
 - check cohorts and any important notices
-- review school moves - see [Reviewing school moves](/guide/school-moves.md)
-- schedule sessions - at least the sessions due to take place in the next month need to be scheduled in Mavis so that consent invitations can go out to parents in time - see [Scheduling and editing sessions](/guide/sessions.md)
-- invite some children to clinics, for example if they are immunosuppressed and need to be prioritised for flu vaccination - see [Vaccinating in community clinics](/guide/community-clinics.md)
+- review school moves - see [Reviewing school moves](school-moves.md)
+- schedule sessions - at least the sessions due to take place in the next month need to be scheduled in Mavis so that consent invitations can go out to parents in time - see [Scheduling and editing sessions](sessions.md)
+- invite some children to clinics, for example if they are immunosuppressed and need to be prioritised for flu vaccination - see [Vaccinating in community clinics](community-clinics.md)
 
 All consent, triage, and PSD results expire at the end of each school year so you will need to add this information again in the new school year.
 
diff --git a/app/guide/record-offline.md b/app/guide/record-offline.md
@@ -95,7 +95,7 @@ Then in Mavis:
 6. Correct the issues listed and try again.
 7. Wait for the file to finish importing.
 
-Once the file has finished uploading, there may be some import issues that you need to review before doing anything else (see [Resolving issues when uploading files](/guide/vaccination-history/#resolving-issues-when-uploading-files)).
+Once the file has finished uploading, there may be some import issues that you need to review before doing anything else (see [Resolving issues when uploading files](vaccination-history.md#resolving-issues-when-uploading-files)).
 
 ### Updating subcutaneous vaccinations
 
diff --git a/app/guide/recording-as-hca.md b/app/guide/recording-as-hca.md
@@ -14,4 +14,4 @@ If you’re a healthcare assistant, only children who have had a PSD added by a
 
 You’ll see a list of all children who have had a PSD added by a prescriber and are ready to be vaccinated. The vaccination method is shown clearly as nasal spray. You can record nasal spray vaccinations for these children.
 
-For more on how to record vaccinations in Mavis, see [Recording a vaccination or non-vaccination](/guide/recording-vaccinations.md)
+For more on how to record vaccinations in Mavis, see [Recording a vaccination or non-vaccination](recording-vaccinations.md)
diff --git a/app/guide/recording-vaccinations.md b/app/guide/recording-vaccinations.md
@@ -56,4 +56,4 @@ You can see how many vaccinations you’ve given today by selecting **Your vacci
 
 ![Screenshot of tally of vaccinations given by the user today.](/assets/images/record-vaccinations-tab-with-tally.png)
 
-You can see how many vaccinations have been given by the team as a whole in the **Session overview** tab. (See [Keeping track of sessions](/guide/keeping-track-of-sessions.md))
+You can see how many vaccinations have been given by the team as a whole in the **Session overview** tab. (See [Keeping track of sessions](keeping-track-of-sessions.md))
diff --git a/app/guide/reporting.md b/app/guide/reporting.md
@@ -29,7 +29,7 @@ Child-level vaccination reports include detailed vaccination data for the select
 
 You’ll need to select a file format before downloading the report.
 
-If your team, or the team you’re sharing the data with, uses SystmOne alongside Mavis, select **CSV for SystmOne (TPP)**. For more information, read [Sharing vaccination records between Mavis and SystmOne](/guide/sharing-vaccination-records-between-mavis-and-systmone/).
+If your team, or the team you’re sharing the data with, uses SystmOne alongside Mavis, select **CSV for SystmOne (TPP)**. For more information, read [Sharing vaccination records between Mavis and SystmOne](sharing-vaccination-records-between-mavis-and-systmone.md).
 
 ## Aggregate vaccination reports
 
diff --git a/app/guide/sharing-consent.md b/app/guide/sharing-consent.md
@@ -7,7 +7,7 @@ eleventyComputed:
     key: Sharing consent forms with schools
 ---
 
-If schools have not provided parents’ contact details, they’ll need to send out consent requests and consent reminders that you’ve provided them with. See [email and text message templates for parents](/email-and-text-templates).
+If schools have not provided parents’ contact details, they’ll need to send out consent requests and consent reminders that you’ve provided them with. See [email and text message templates for parents](../email-and-text-templates/index.md).
 
 ## How to use the templates
 
diff --git a/app/guide/sharing-vaccination-records.md b/app/guide/sharing-vaccination-records.md
@@ -28,12 +28,12 @@ If a record cannot be synced, Mavis explains why and in some cases will tell you
 
 ## If a child self-consents under Gillick competence
 
-If a child self-consents under Gillick competence and asks for their parents not to be informed, the record will not be synced and you must let the child’s GP know they were vaccinated. These records will be flagged to Superusers as an important notice - see [Checking important notices](/guide/notices/).
+If a child self-consents under Gillick competence and asks for their parents not to be informed, the record will not be synced and you must let the child’s GP know they were vaccinated. These records will be flagged to Superusers as an important notice - see [Checking important notices](notices.md).
 
 ![Screenshot of a vaccination record that is not synced.](/assets/images/fhir-imms-not-synced.png)
 
 ## Sharing records with CHIS
 
 You must share vaccination records for all programmes with CHIS manually.
 
-To do this, download child-level vaccination reports as CSV files from the **Reports** area of Mavis and send them to your CHIS provider. For more information, read [Downloading vaccination reports](/guide/reporting/).
+To do this, download child-level vaccination reports as CSV files from the **Reports** area of Mavis and send them to your CHIS provider. For more information, read [Downloading vaccination reports](reporting.md).
diff --git a/app/guide/statistics-for-vaccinations-and-schools.md b/app/guide/statistics-for-vaccinations-and-schools.md
@@ -47,4 +47,4 @@ You can use filters to view data for specific programmes, genders and year group
 
 Schools are listed in ascending order by unique reference number (URN).
 
-This data is also available to download as a CSV report (see [Downloading vaccination reports](/guide/reporting/)).
+This data is also available to download as a CSV report (see [Downloading vaccination reports](reporting.md)).
diff --git a/app/guide/vaccination-history.md b/app/guide/vaccination-history.md
@@ -106,7 +106,7 @@ If there are some parts of each that are correct, you can note down any correct
 
 ## Manually recording a child as 'already vaccinated'
 
-If a child’s historical vaccination record is missing from CHIS data, or you have not been able to upload their historical vaccination record into Mavis, you can manually record the child as ‘already vaccinated’ for a specific programme. You can only do this once sessions have been scheduled (setting up sessions is covered in the ['Sessions'](/guide/sessions.md) section of this user guide).
+If a child’s historical vaccination record is missing from CHIS data, or you have not been able to upload their historical vaccination record into Mavis, you can manually record the child as ‘already vaccinated’ for a specific programme. You can only do this once sessions have been scheduled (setting up sessions is covered in the ['Sessions'](sessions.md) section of this user guide).
 
 1. From Sessions, select a session that is not currently in progress.
 2. Search for the child under the **Children** tab - then click on the child’s name to open the child record.

Original file line number	Diff line number	Diff line change
`@@ -14,4 +14,4 @@ If your team uses patient specific directions (PSDs) for flu vaccinations, you c`
`14`	`14`
`15`	`15`	`![Screenshot of session delegation settings.](/assets/images/enable-psd.png)`
`16`	`16`
`17`		`-Any user can turn this feature on for a session. Once it’s enabled, users with a prescriber role can add PSDs to named children (see [Reviewing and adding PSDs](/guide/reviewing-and-adding-psds/)).`
	`17`	`+Any user can turn this feature on for a session. Once it’s enabled, users with a prescriber role can add PSDs to named children (see [Reviewing and adding PSDs](reviewing-and-adding-psds.md)).`