Skip to content

Docs/audiodocs cleanup#1156

Open
SomePersonFromMars wants to merge 18 commits into
mainfrom
docs/audiodocs-cleanup
Open

Docs/audiodocs cleanup#1156
SomePersonFromMars wants to merge 18 commits into
mainfrom
docs/audiodocs-cleanup

Conversation

@SomePersonFromMars

@SomePersonFromMars SomePersonFromMars commented Jul 9, 2026

Copy link
Copy Markdown
Collaborator

Closes RNAA-483

⚠️ Breaking changes ⚠️

Introduced changes

  • Standardized audio node documentation across the site - shared inheritance sections, property/method tables, and consistent parameter descriptions.
  • Improved clarity and consistency in system docs (AudioManager, playback/recording notification managers), utility docs (decoding, hooks), and the "Other" section (testing, permissions, plugin setup).
  • Added reusable audiodocs components (AudioNodeInheritedSection, AudioNodeMethodsTable, enhanced AudioNodePropsTable) to reduce duplication and keep node pages uniform.
  • Replaced the static oscillator waveform image with an interactive OscillatorWavesChart component and refreshed related type documentation.
  • Applied minor editorial cleanup across node, worklet, and type docs (notation, wording, and structure).

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

Affected AnalyserNode docs and CLAUDE instructions.
* AudioDestinationNode documentation is now more robust.
* Add AudioNodeInheritedSection for shared AudioNode tables code,
* also add new AudioNodeMethodsTable,
* and update AudioNodePropsTable for more clarity.
…ocumentation

* Introduced a new OscillatorWavesChart component to visualize oscillator waveforms.
* Replaced static image in oscillator-type documentation with the new chart component for better
interactivity and clarity.
* Added CSS styles for the new chart component and defined color variables for different wave types
in colors.css.
* Removed the outdated oscillator-waves.png image.
@mdydek mdydek added the documentation Improvements or additions to documentation label Jul 9, 2026
@SomePersonFromMars SomePersonFromMars requested a review from mdydek July 9, 2026 10:35

Audio graph rendering is done in blocks of sample-frames. The number of sample-frames in a block is called render quantum size, and the block itself is called a render quantum.
By default render quantum size value is 128 and it is constant.
By default render quantum size value is `128` and it is constant.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Suggested change
By default render quantum size value is `128` and it is constant.
By default render quantum size value is `128` and it is a constant.


Inherits all methods from [`AudioNode`](/docs/core/audio-node#methods).

<AudioNodeMethodsTable />

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

if you have this component created, you can use it in all the places, you are mentioning that "node inherits all methods from audioNode"

Comment on lines -56 to -59
:::info
For more details, go to [android developer page](https://developer.android.com/develop/ui/views/notifications#Templates).
Resource name is a path to resource plased in res/drawable folder. It has to be either .png file or .xml file, name is indicated without file extenstion. (photo.png -> photo).
:::

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I think info block can be left here

### `decodeAudioData`

Decodes audio data from either a file path or an ArrayBuffer. The optional `sampleRate` parameter lets you resample the decoded audio;
Decodes audio data from either a file path or an [`ArrayBuffer`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer). The optional `sampleRate` parameter lets you resample the decoded audio;

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I get it that it was previously like that, but current implementation decodes also from app assets, so its worth mentioning it

Comment on lines 157 to +162
| Parameter | Type | Description |
|-----------|------|-------------|
| `base64String` | `string` | Base64-encoded PCM audio data. |
| `inputSampleRate` | `number` | Sample rate of the input PCM data. |
| `inputChannelCount` | `number` | Number of channels in the input PCM data. |
| `isInterleaved` <Optional />| `boolean` | Whether the PCM data is interleaved. Default is `true`. |
| `isInterleaved` <Optional />| `boolean` | Whether the PCM data is interleaved. Defaults to `true`. |

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

here it is rendered differently than upper tables, which makes default behavior different, one is centering text and the other not, unify it

Use AudioNodePropsTable and AudioNodeMethodsTable on all pages that extend
AudioNode directly, fill gaps on IIRFilterNode and worklet nodes, and update
audiodocs/CLAUDE.md and the flow skill template accordingly.
- Left-align description/value columns and center name/type columns
  in AudioNodePropsTable and AudioNodeMethodsTable
- Wrap notification-manager resource note in an info admonition
- Minor decoding.mdx table alignment and wording fixes
- Rename AudioDecoder.resolveStringSource -> resolveToStringSource
  and tighten its return type
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.

2 participants