govuk-prototype-kit icon indicating copy to clipboard operation
govuk-prototype-kit copied to clipboard

Technical investigation of options for new documentation website

Open ruthhammond opened this issue 1 year ago • 2 comments

What

Investigate and complete a technical review of the potential options for our new website.

The frontrunner is currently 11ty, but what are other GDS teams using? The Design System are using Metalsmith, but are considering moving off it, as it's no longer well supported. Could one of the options be Express?

Is a static site suitable for our needs, or would we need something with dynamic options? Do we need to think about where we're going to store the data?

Time boxed to a day.

Why

So we know the pros and cons of the options before deciding where to move. We evaluate the features each option would provide.

Who might do this

Developer

Done when

  • [ ] Options are identified
  • [ ] A technical review of each option is complete
  • [ ] Conclusions and recommendations are shared and discussed with the team

Refinement tasks

  • [ ] User need / benefit clarified
  • [ ] Owner(s) identified
  • [ ] Tasks, actions and milestones identified
  • [ ] Triage / ticket refinement complete

ruthhammond avatar Jun 01 '23 14:06 ruthhammond

Needs a scope to be defined for the new site first

ruthhammond avatar Jun 15 '23 11:06 ruthhammond

@nataliecarey @BenSurgisonGDS @ruthhammond @alanmccoyPTK We've completed the docs site spec here: https://github.com/alphagov/govuk-prototype-kit/issues/2228

oli-rose28 avatar Jul 18 '23 16:07 oli-rose28