Update information architecture

[jonathanglassman]

Context

Firebreak project to improve the docs information architecture

Changes proposed in this pull request

New information architecture, split into different stages of a project.

Guidance to review

Does this make sense?

[bravegrape]

As per Show and Tell discussion, this is a much needed reorganisation of the docs for the tech docs tool ✨

How about shuffling some content around:

• move 'Middleman options' under 'Amend your project'
• break up 'Publish your documentation' into separate pages about deploying, hosting etc
• move 'Page expiry and review' up one level to be the same level as 'Review your documentation'

Also sounds like 'Review your project' is more about reviewing docs so maybe worth renaming?

For the google docs marked 'requires permission to access' is there a specific reason we can't open up the useful content?

How about dropping 'amend' in favour of the more commonly used 'edit'? Here are some interesting insights from Google Trends: https://trends.google.com/trends/explore?date=all&geo=GB&q=amend,edit

Can we find a plan English alternative to 'Governance'?

I think it looks much, much better than the previous structure. I have a few suggestions - let me know what you think 😁

[jonathanglassman]

As per Show and Tell discussion, this is a much needed reorganisation of the docs for the tech docs tool ✨

How about shuffling some content around:

• move 'Middleman options' under 'Amend your project'
• break up 'Publish your documentation' into separate pages about deploying, hosting etc
• move 'Page expiry and review' up one level to be the same level as 'Review your documentation'

Also sounds like 'Review your project' is more about reviewing docs so maybe worth renaming?

For the google docs marked 'requires permission to access' is there a specific reason we can't open up the useful content?

How about dropping 'amend' in favour of the more commonly used 'edit'? Here are some interesting insights from Google Trends: https://trends.google.com/trends/explore?date=all&geo=GB&q=amend,edit

Can we find a plan English alternative to 'Governance'?

I think it looks much, much better than the previous structure. I have a few suggestions - let me know what you think 😁

Agree with your suggestions, however I'm a bit stumped as to why 'Page expiry and review' is not the same level as 'Review your documentation' - do you know? I'll make the other changes now.

[bravegrape]

Agree with your suggestions, however I'm a bit stumped as to why 'Page expiry and review' is not the same level as 'Review your documentation' - do you know? I'll make the other changes now.

Fixed it by moving page-expiry.html.md.erb out into its own folder and renamed it to index.html.md.erb. The nested page implementation is a bit strange...

[jonathanglassman]

Agree with your suggestions, however I'm a bit stumped as to why 'Page expiry and review' is not the same level as 'Review your documentation' - do you know? I'll make the other changes now.

Fixed it by moving page-expiry.html.md.erb out into its own folder and renamed it to index.html.md.erb. The nested page implementation is a bit strange...

Looks good, let me know what you think

[bravegrape]

I think this looks good to merge 👍