Tech Docs IA change to support hierarchical relationships between pages

[ty2k]

The information architecture (IA) of the Tech Docs site is currently flat. Pages are generated from Markdown documents that live in the ./src/docs/ folder, where the sub-directory structure denotes the menu group that documents will live in within the navigation menu.

It was determined in a June 7 Tech Docs content meeting that we would need a hierarchical relationship between pages, where certain topics that are broken into several documents (like Artifactory or Sysdig) would get parent landing pages that link to child content detail pages.

This will necessitate changes to:

• the docs folder directory structure
• the navigation menu
• the Markdown Remark template and its GraphQL query
• creation of a breadcrumb component

Additional context

• Previously, the site was following the flat IA and menu structure from the GOV.UK Platform as a Service site
• The hierarchical IA in the WordPress Private Cloud PaaS site has a breadcrumb menu for visual reference

Definition of done

• [ ] Documents directory structure is updated to reflect hierarchical site IA
• [ ] Navigation menu allows navigation to parent/landing pages. Navigation to child pages can be limited to links on the parent/landing pages in order to keep the overall length of the navigation menu shorter.
• [ ] Visual breadcrumbs appear at the top of the page to show the page's location in the IA

[lukegonis]

This issue is no longer needed/relevant