Skip to content

Docs cleanup and unification#961

Open
michalsek wants to merge 21 commits intomainfrom
fix/docs-ui-ux-and-ix
Open

Docs cleanup and unification#961
michalsek wants to merge 21 commits intomainfrom
fix/docs-ui-ux-and-ix

Conversation

@michalsek
Copy link
Member

@michalsek michalsek commented Feb 20, 2026

Closes RNAA-237

⚠️ Breaking changes ⚠️

  • none

Introduced changes

  • layout / styling / etc changes to unify examples and snippets with landing page color scheme
  • fixes various smllaer problems with the docs UI

Checklist

  • Linked relevant issue
  • Updated relevant documentation
  • Added/Conducted relevant tests
  • Performed self-review of the code
  • Updated Web Audio API coverage
  • Added support for web
  • Updated old arch android spec file

@michalsek michalsek self-assigned this Feb 23, 2026
@michalsek michalsek marked this pull request as ready for review February 23, 2026 18:57
@michalsek michalsek added the documentation Improvements or additions to documentation label Feb 23, 2026
Copy link
Contributor

@mdydek mdydek left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. highlighted parts can overlap each other and it does not look appealing (oscillator page)
  2. lines for highlighted links do not end with the end of word, but they spread across all highlighted area (oscillator page), also they are doubled, removal of a line in typography.css file, fixes the issue
border-bottom: 1px solid var(--ifm-font-color-base);
  1. all interactive playgrounds have weird spacing between code part and interactive part
  2. highlighting colors in warning looks still off (decoding page)
  3. on first render of oscillator interactive playground there is no line visible, whereas f.e. in audiobuffersource one it is visible

Copy link
Collaborator

@maciejmakowski2003 maciejmakowski2003 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

great work, it looks really fresh. I have a few remarks:

  • do we still want to use blue for badges like below?
Image
  • maybe let's use red for warning/caution(or only yellow), blue for info, green for good practice/tip?

  • blue for files drop downs? what's the exact convention?

Image


import OscillatorSquare from '@site/src/components/OscillatorSquare';

<OscillatorSquare />
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image

that red color backlight is really annoying.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants