docs(sound): READMEs do not say that sound and music start muted

未关闭
#510 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

@stanislaw-ch 已经在做这个了。

开始于 2026年11月11日。

  • #512 来自 @stanislaw-ch —— 未关闭

评估

难度
1/5
预计耗时
1-3 小时
新手友好度
20/100
Issue 类型
文档
描述清晰度
描述清楚
活跃度
停滞
技术栈
typescript
领域
documentation

调研方向

Read modules/sound/README.md and modules/music/README.md, then compare their mute guidance with the initialization and class TSDoc in modules/sound/src/sound.library.ts and modules/music/src/music.library.ts. The issue suggests documenting that both start muted and calling mute() enables audio, or changing the default; a linked open pull request already addresses this issue.

由索引模型根据 Issue 内容生成。

描述

documentation good first issue modules:music modules:sound
What is the type of issue?

Documentation is missing

What is the issue?

Both libraries set _muted = true in __init. A user who follows the README (load then play) hears nothing until they call mute(), which the README only describes as a toggle. No docs/docs page exists for sound or music.

Evidence:

private _muted = true;
...
this._muted = true;

Suggested fix: State "starts muted; call mute() once to enable audio" in both READMEs and the class TSDoc, or start unmuted.

Found during a code audit of main at be72076.

Where did you find it?
主要语言
TypeScript
星标
7
派生
2
平均合并
1 天 17 小时
30 天内合并 PR
17

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

NanoForge-dev/Engine 的其他 Issue

查看 NanoForge-dev/Engine 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。