mdn/content

Content bug: AudioListener and attributes need better examples.

Open

#4,468 opened on Apr 26, 2021

View on GitHub
 (0 comments) (0 reactions) (0 assignees)Markdown (22,427 forks)batch import
Content:WebAPIarea: Web Audioeffort: mediumhelp wanted

Repository metrics

Stars
 (8,900 stars)
PR merge metrics
 (Avg merge 7d 3h) (147 merged PRs in 30d)

Description

https://developer.mozilla.org/en-US/docs/Web/API/AudioListener

As discussed in https://github.com/mdn/content/pull/4401#discussion_r619372451 AudioListener and all the attributes link to the same example https://developer.mozilla.org/en-US/docs/Web/API/PannerNode#examples

This is not actually all that relevant to all the attributes, and is probably more comprehensive than required at this level. It would be better to have small focussed example for each of these and cross link to the example as a see also.

Contributor guide

Research direction
Write small, focused examples for each AudioListener attribute (e.g., positionX, positionY, positionZ, forwardX, forwardY, forwardZ, upX, upY, upZ) demonstrating their usage in a simple Web Audio context. Cross link to the existing PannerNode example as a 'See also'.
Tech stack
None
Domain
documentation
Issue type
Documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
Web Audio API basics
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
80