Add documentation for releasing GOV.UK Frontend from a support branch

[vanitabarrett]

Closes #1958

Documentation for releasing a patch fix (e.g: urgent or security fix) when there are unreleased changes on main that can't go out yet. This process was trialled for the 3.14.0 release in an artificial scenario (in reality, we'd likely only follow this process for patch fixes)

[vanitabarrett]

@EoinShaughnessy Does this need to go through pre-i/2i?

[lfdebrux]

These links can be relative

[lfdebrux]

A couple of extra snags:

[lfdebrux]

Apart from the issues above, this looks good to me 👍

Thank you for organising this and putting it together 🙌

[EoinShaughnessy]

@vanitabarrett Yeah, this should probably go through pre-i and 2i. Even if we're the ones using it, it might yet reach eyes outside of the team (like if we ever surface it in the Tech Docs Template). If that sounds ok, I'll ask for pre-i/2i.

[vanitabarrett]

Sounds good to me, thanks @EoinShaughnessy !

[EoinShaughnessy]

Have sent content for pre-i.

[EoinShaughnessy]

@vanitabarrett If you un-assign me as a reviewer, will that allow me to commit suggestions into the doc?

[seaemsi]

Have suggested a few small changes and made some comments.

[EoinShaughnessy]

@vanitabarrett Doc has passed 2i. Before we merge this - should the doc title match the filename? Currently, the doc title (i.e., displayed at the top of the doc) is 'Publish GOV.UK Frontend when main branch has unreleasable changes', and the filename is 'publishing-from-a-support-branch.md'.

[vanitabarrett]

Thanks @EoinShaughnessy ! Yeah I wasn't too sure on the best filename for this to be honest. Trying to make "Publish GOV.UK Frontend when main branch has unreleasable changes" into a filename seemed a bit difficult 😅

[EoinShaughnessy]

@vanitabarrett Ha, yeah tricky alright! Have changed doc title to match filename. Hope that's ok. Did this because:

• those 2 things should match ideally
• it means a less verbose title
• it mirrors the approach of other doc titles ('Publishing', 'Testing and linting') in the same folder
• the first line of the doc basically reiterated the previous title - "This document is for GOV.UK Design System developers who need to publish a support branch of GOV.UK Frontend when the main branch contains unreleasable changes."

[vanitabarrett]

Thanks @EoinShaughnessy , seems sensible. Do you think we still need that second heading 'publish GOV.UK Frontend from a support branch' in that case?

[EoinShaughnessy]

@vanitabarrett You're right, that heading can go. I've deleted it and made the headings after it into either H2s (if they were H3s before) or H3s (if they were H4s before).