[epic][doc] Redesign of UX dot documentation site + new IA

[markcaron]

This EPIC tracks all the redesign work of ux.redhat.com and new site architecture (IA), including code documentation, design documentation, and accessibility documentation.

Original discussion thread: #351

All IA issues associated with this EPIC are the following:

Template changes, build scripts and other necessary dependencies:

• [docs]: New component page structure and adding code documentation (IA updates) #414
  • [docs]: Implement New IA templates + update rh-footer docs #606
  • [docs]: Implement new IA for rh-cta #610
  • [docs]: Implement new IA for rh-alert #820
  • [docs]: Implement new IA for rh-accordion #822
  • [docs]: Implement new IA for rh-avatar #823
  • [docs]: Implement new IA for rh-blockquote #824
  • [docs]: Implement new IA for rh-button #825
  • [docs]: Implement new IA for rh-dialog #826
  • [docs]: Implement new IA for rh-navigation-secondary #827
  • [docs]: Implement new IA for rh-statistic #828
  • [docs]: Implement new IA for rh-tabs #829
  • [docs]: Implement new IA for rh-tooltip #830
• [feat] <rh-subnav> #703
• [docs] Anchor linking for headings #119
• [feat] <rh-clipboard-copy> component #423

New docs pages/sections:

• [docs] New Component section - Design Tokens #315
• [docs] ux.redhat.com | New page - Layout #357
• [docs] New page - E-mail #332
• [docs] New section - Accessibility #309
• [docs] New page - Motion #358
• [docs]: Add Tokens pages  #719
• [docs] Create Roadmap page #772
• [docs] Revise the Getting Started docs #1176
• [docs] Create How to Contribute page #1175
• [docs] Create CDN section on Developers Getting Started #1177

New component pages:

• [feat] Create <rh-navigation-universal> element #310
• [docs] new component page - breadcrumb #311
• [docs] New Component page - mobile #313
• [docs] New Component page- switch #316
• [docs] New Component page- audio player #317
• [docs] Spinner docs need review/cleanup #904

Updates to existing doc pages:

• [bug] Broken images and missing headings on All Elements and All Patterns pages #890
• [docs]: Add font styles to playground demos #896
• [docs] playground CSS in ux.redhat.com #906
• [bug] Auto rebuild not working in elements/docs folder #907
• [docs] Update Color page #1261

[markcaron]

Looping in part of a discussion around the IA:
#351

[bennypowers]

For tokens, let's use and extend the work done in the tokens repo

• document tokens inline in their source YAML files
• generate the pages on ux-dot with the nunjucks templates and filters already written
• any design changes needed are naturally welcome

[coreyvickery]

@paigenotfound404 @markcaron I can see this epic being open for a very long time unless we reduce the number of linked issues. Can we remove some issues that we know are not going to be worked on for a while?

[coreyvickery]

@markcaron We should rethink some of these line items if they are worth doing.

[bennypowers]

Point of order: I assigned this to @hellogreg since it's an epic. Please assign child issues to individual associates who can take responsibility for them.

[coreyvickery]

@markcaron @hellogreg Proposing moving the following issues to the Chansey or Charmander release so we can close this epic before EOY.

• [docs] New section - Accessibility #309
• [docs] Create How to Contribute page #1175
• [docs] Create CDN section on Developers Getting Started #1177
• [feat] Create <rh-navigation-universal> element #310
• [docs] New Component page- switch #316

[hellogreg]

Thanks @coreyvickery . Placed these all in Chansey, for now. Maybe #309 can be moved to Caterpie, if we feel it's close, but we won't assume, for now.

[bennypowers]

of the four remaining tasks in the issue description, 3 are cued up for clefairy, but one is scheduled for cubone. that means that this epic issue won't be closed until cubone at the earliest, so i set it's milestone accordingly