Skip to content

Add tags to ALL THE THINGS#340

Draft
jabley wants to merge 1 commit intomainfrom
consistent-tagging
Draft

Add tags to ALL THE THINGS#340
jabley wants to merge 1 commit intomainfrom
consistent-tagging

Conversation

@jabley
Copy link
Contributor

@jabley jabley commented Dec 23, 2025

This will teach me to look before I volunteer. A casual request in Slack turned into "Oh, quite a lot of posts don't have tags, whoops!".

2 aims with this change:

  1. Add tags to all existing posts that are missing them.
  2. Try to be consistent with tagging across similar posts, so that future posts can follow the same pattern.

Other opinions are equally valid.

For reviewers: please check that the tags I've added make sense,
and that I've been consistent where it matters. If you think some tags
should be different, please suggest what they should be instead.

Ideally the diffs will be either an insert of tags for posts that didn't
have any at all, or a renaming to be consistent with other similar
posts.

WIP

Marked as WIP because I want to check a few more items to see that tags are working as expected. Currently /manage-vaccinations-in-schools/2025/09/flu-consent/ shows the tags on the page but doesn't show up in /tags/ or /tags/vaccinations so I don't think this is quite right yet.

@edwardhorsford edwardhorsford temporarily deployed to dsps-design-consistent--meqecc December 23, 2025 15:36 Inactive
@frankieroberto
Copy link
Collaborator

@jabley thanks for doing this!

I had a quick look at the issue you mentioned, and the only tag that doesn't work is vaccinations. Digging into it a bit, this is because Eleventy confusingly implements collections using tags, and we already have a collection/service called vaccinations for posts that cut across multiple vaccinations teams: https://design-history.prevention-services.nhs.uk/vaccinations/

These are defined in this list: https://github.com/NHSDigital/prevention-services-design-history/blob/main/eleventy.config.js#L119-L156 in eleventy.config.js.

There’s probably a few workaround for this naming collision, however I’m not sure that 'vaccinations' is a useful tag anyway (given it applies to half the posts)? Could we instead prefer more specific tags, like flu vaccine, RSV vaccine and pertussis vaccine (which we have already)?

Similarly we could avoid generic tags like service and user research, and perhaps the alpha, beta etc ones?

Useful ones would be the more specific terms which might still span multiple services, things like test results, appointment booking, logging in, consent, referrals and so on? Might be harder to add though!?

@jabley jabley force-pushed the consistent-tagging branch from 44c7855 to 294c137 Compare January 20, 2026 16:50
This will teach me to look before I volunteer. A casual request in Slack
turned into "Oh, quite a lot of posts don't have tags, whoops!".

2 aims with this change:

1. Add tags to all existing posts that are missing them.
2. Try to be consistent with tagging across similar posts, so that
   future posts can follow the same pattern.
@jabley jabley force-pushed the consistent-tagging branch from 294c137 to 5238147 Compare January 20, 2026 16:53
@jabley
Copy link
Contributor Author

jabley commented Jan 22, 2026

One option might be to generate a set of potential tags to apply and add some tooling npm suggest-tags or similar to highlight which posts might want to have some tags added.

The set of tags that we want is probably under 100 and can be quickly generated via a word cloud / synonym analysis. A session with an agent yielded the following:

User Actions & Journeys:

  • appointment booking - scheduling, creating availability, managing appointments
  • consent - parental consent, self-consent, Gillick competence, consent refusal
  • authentication - logging in, NHS login, CIS2, smartcards, identity verification
  • referrals - self-referral, GP referral, service referral
  • notifications - invitations, reminders, alerts, emails, SMS
  • results - test results, screening results, viewing results, sharing results
  • registration - patient registration, service registration, attendance

Service Patterns:

  • triage - health questions, medical history, contraindications
  • recording - vaccination recording, data entry, appointment recording
  • searching - finding patients, finding records, search functionality
  • matching - matching records, deduplication, identity matching
  • importing - data import, CSV upload, batch processing
  • reporting - analytics, monitoring, dashboards

Technical & System:

  • offline functionality - working offline, sync, data protection
  • workflows - approval workflows, processes, task management
  • user management - roles, permissions, access control
  • data quality - validation, error handling, data integrity
  • integration - PDS, CHIS, external systems

Content & Communication:

  • content design - forms, questions, guidance
  • accessibility - inclusive design, WCAG compliance
  • multi-language - translations, language support

Do we like this vocabulary and suggested approach?

@emloja
Copy link

emloja commented Jan 28, 2026

In Vaccinations we've been working on establishing a set of end-to-end service stages that apply to all (or most) vaccination services. I'd like to be able to tag the design history posts with the relevant service stage names.

Things to consider:

  1. Stage names might change, therefore we might want to update the tag.
  2. Related to (1), we might want to know which posts are affected so we can consider if the new tag applies. Eg if stages are changed significantly, an existing post might no longer be aligned with the stage it was previously aligned to.
  3. I'm not sure how easy it is to identify which stage a post should be tagged with from a set of keywords. It might be helpful to test this.
  4. Some posts will need to be tagged with multiple service stages, some with none.
  5. At the moment this only applies to vaccinations. But in future it could apply more broadly to other DPSP services.

Examples are as follows. Complete list as a work in progress is in Mural.

Emphasis on public:

  • Become aware
  • Decide
  • Find or book
  • Get ready / wait (tbc)
  • Arrange next vaccination

Emphasis on provider:

  • Set up
  • Plan & get stock
  • Vaccinate
  • Record & share
  • Get paid

@frankieroberto frankieroberto temporarily deployed to dsps-design-consistent--anjvvz February 27, 2026 10:25 Inactive
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants