Skip to content

Typopgraphy: Update documentation #2410

Description

@SergejLust

Detailed description of how to reproduce the problem

  1. Open Storybook and navigate to the typography foundations documentation page (MDX).
  2. Locate the typography table on the page.
  3. Observe that the information the table presents (type styles, sizes, weights, line heights, and any related columns) is already available elsewhere in the DDS reference material, so the table duplicates content that lives closer to the source of truth.
  4. Observe that the page does not link to the source-of-truth typography definitions in Figma and does not point developers to the existing CSS & SCSS token documentation.

Actual behavior: The typography foundations documentation page carries a typography table whose content is redundant with the primary source-of-truth references. Maintaining the same information in two places creates drift risk and clutters the page without adding value for either designers or developers. The page also lacks a direct link to the source-of-truth typography definitions in Figma and does not point developers to the existing CSS & SCSS token documentation.

Expected behavior: The typography table is removed from the typography foundations documentation page. Surrounding prose, headings, examples, and any other page content stay in place. A link to the Figma "Typography" page is added so designers can jump to the source of truth in one click, and a link to the CSS & SCSS token page is added so developers reach the code-side token reference directly.

Upload a screenshot

Image

Describe the development framework

Infineon Design System (DDS) component library — Stencil-based Web Components authored in TypeScript, with styles written in SCSS. Documented and previewed in Storybook (MDX). Issue affects the typography foundations documentation page only.

Expected behavior

  • The typography table is removed from the typography foundations documentation page in its entirety.
  • No table content is reorganized, split, or moved elsewhere — it is dropped, since the information is already available at the source-of-truth reference.
  • All other content on the typography foundations page — introduction copy, section headings, examples, captions, and any images — remains in place and unchanged.
  • Link reference to the Figma "Typography" page added to the documentation page.
  • Link reference to the CSS & SCSS token documentation page added to the documentation page.
  • No changes to the typography tokens themselves in code — documentation change only.
  • No API changes on any component.

Additional information

  • Documentation-only change. No component code, no SCSS variable changes, no token layer changes.
  • Rationale: The typography table duplicates content that lives closer to the source of truth for the audience that reads it. Removing it eliminates a drift risk (two places to update when a type style changes) and keeps the foundations page focused on the information that only lives there. The added Figma link makes the source of truth reachable directly from the documentation page. The added CSS & SCSS token link routes developers to the code-side token reference so the page can shed the redundant table without losing the pointer for developers who need it.
  • Assumption to confirm: exact Storybook MDX page path was not specified in the input — please confirm which page (e.g. Foundations → Typography) the change applies to, the exact Figma URL to be linked, and the exact Storybook path of the CSS & SCSS token page to be linked.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingminorminor version bumprequestUser request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions