Write up decisions on package structure and JavaScript formats in v5

[36degrees]

What

Write up a decision record that covers the structure of the published GOV.UK Frontend package in v5, including:

• the flavours of JavaScript provided
• directory structure
• filenames and file extensions

The decision record should live in the architecture repo and follow the same format as the provided template.

Why

Writing up these decisions gives us a place to record the rationale, which will help our future selves when we want to understand why things are the way they are.

It will also ensure we're all on the same page in the short term, and aid us when reviewing code changes.

Finally, we can use it to communicate the upcoming changes to the rest of the team and to our users.

Who needs to work on this

Developers

Who needs to review this

Developers, Tech Writer?

Done when

• Decision record written up
• Decision record reviewed and merged

[36degrees]

@claireashworth I've added 'tech writers' to the 'Who needs to review this?' but unsure if it's a good use of your time? I'll leave it up to you to decide how much you want to be involved – happy to chat about it if useful.