ic-design-system icon indicating copy to clipboard operation
ic-design-system copied to clipboard

Consolidate navigation guidance from styles and patterns

Open GCHQ-Developer-718 opened this issue 4 months ago • 1 comments

Description

Consolidate the navigation guidance currently in Styles > Templates and Patterns > Navigation patterns, by moving all guidance to Patterns > Navigation patterns.

The navigation patterns section should have the following layout:

Overview

As it is now

Top navigation layout

Split into guidance and code tabs. Guidance: use guidance currently in Styles > Templates > Top navigation Code: examples currently in Patterns > Top navigation layout

Side navigation layout

Split into guidance and code tabs Guidance: use guidance currently in Styles > Templates > Side navigation Code: examples currently in Patterns > Side navigation layout

Secondary navigation

Guidance only. Use guidance currently in Styles > Templates > Secondary navigation. Add links to relevant components

Acceptance criteria

  • Styles > Templates removed
  • Patterns > Navigation patterns updated as described above
  • Each pattern links to relevant components
  • All relevant components have a link to relevant patterns (including from Components > Code)

Why do we need it?

It can be difficult to find all the available information on different types of navigation. Consolidating it into patterns with guidance and code examples will make this easier.

Many developers don't realise patterns with code examples are available. Linking to them from relevant component > code sections will help with this.

🚨 Urgency (low, medium or high)

Related open issues

[Link to other GitHub issues]

GCHQ-Developer-718 avatar Sep 15 '25 14:09 GCHQ-Developer-718

Include Tree View and Table of Contents in the navigation section too

MI6-255 avatar Oct 23 '25 08:10 MI6-255