Review and change information architecture

[vickytnz]

The old document site is very much based on the NHS Frontend install https://nhsuk.github.io/nhsuk-frontend/ which is a different use case from the prototype kit.

It makes more sense to align it with a mix of:

• the GOV.UK prototype kit https://prototype-kit.service.gov.uk/docs/
• more gov product oriented sites like NHS notify https://notify.nhs.uk/ govuk pay https://www.payments.service.gov.uk/ or govuk forms https://www.forms.service.gov.uk/

This would help:

• people understand the value of the product
• get started easily
• use other documentation as is needed
• get support if they need it

[vickytnz]

Current site

Home

• Get started
  • Install guide
    • What computer are you using
      • Windows guide (8 steps)
        * Terminal
        * Install Node.JS
        * HTML text editor
        * Download the kit
        * Download and decide where to keep your prototypes
        * Go to your prototype
        * Set up the kit
        * Run the kit
        * Check it works
      • Mac guide (8 steps)
        * Terminal
        * Install Node.JS
        * HTML text editor
        * Download the kit
        * Download and decide where to keep your prototypes
        * Go to your prototype
        * Set up the kit
        * Run the kit
        * Check it works
  • Advanced install guide
• Guides
  • Build a basic prototype using the NHS.UK prototype kit
    • Open your prototype in your editor
    • Create pages
    • Link your pages together
    • Use components from the Design System
    • Add a textarea to question 2
    • Show the user’s answers on the ‘Check answers’ page
    • Let the user change their answers
    • Show different pages depending on user input (branching)
    • Link your index page to your start page
  • (Learn the basics)
    • Making pages
    • Adding CSS, JavaScript and Images
    • Using components
  • (Create journeys with data)
    • Passing data page to page
    • Branching (show a different page based on user input)
  • (Share your prototype)
    • Setting up Git
    • Publish your prototype online
  • Updating the kit
  • (Advanced usage )
    • Switching from the GOV.UK Prototype Kit
• Templates (list of 16 pages)

Footer

• About and support
• NHS.UK prototype kit - Github
• Cookies

[frankieroberto]

@vickytnz nice site map! 🙌

My current thoughts for a future top-level nav/IA are:

• Get started
• Guides
• What’s new (Add an 'updates' page for the NHS prototype kit #101)
• Contribute (Create a standalone page for Contributing #92)
• Support (Create a standalone page for Support #91)

Just an idea though!

[vickytnz]

This ties in with #136 of making the guides landing page work harder which i think also makes it easier to make decisions about how all of those pages fit together.

The footer also needs to include the accessibility statement #94 and privacy notice #95 so I think the footer should be:

• Accessibility statement (to be added) Do accessibility review and add accessibility statement #94
• Cookies
• Privacy policy (to be added) Add privacy notice #95
• Changelog Add an 'updates' page for the NHS prototype kit #101
• Prototype Kit - Github (do we need a separate link to the document site or is it enough to talk about it properly in contributing?)

The main unknowns are:

• the benefits Add page to explain the benefits of prototyping in code #50 - which hopefully can just be on the home page with everything moving to either the main menu or the footer
• whether contributing and support go into the main menu or the footer - normally contribution would go in the footer but it may be worth making it more prominent here

[frankieroberto]

@vickytnz footer list looks good. I’d also agree that the GitHub links moves to being within the 'Contribute' page or wherever else relevant.

Contribute and Support feel important enough to go in the top nav (and the footer?) but 🤷. Maybe the kind of thing that some future research could tell us?

[frankieroberto]

@vickytnz not sure how this got closed. Reopened.

[vickytnz]

tbh this is almost an epic with all of the different parts, I possibly accidentally closed this with the reformatting of the guides page

[vickytnz]

I'd like to add a getting started button (as I think that would also mean we can move it out of the sections and make it thirds) but something is off with the reversed button in that the text won't show up?