Skip to content

Clarify utility discovery and Sound setup - #105

Merged
niharnm merged 2 commits into
mainfrom
nihar/website-utility-alignment
Sep 9, 2026
Merged

niharnm merged 2 commits into
mainfrom
nihar/website-utility-alignment

Conversation

@niharnm

@niharnm niharnm commented Sep 9, 2026

Copy link
Copy Markdown
Owner

Summary

The website's audio guide sent users to source builds without explaining how to open Sound in the module interface, and its general permission summary omitted Workspace Restore. Lead with the packaged Sound installation, explain the separate source-build flow, and distinguish those permissions.

Make the broader utility identity explicit in the hero, metadata, FAQ, about page and footers. Add direct links to all nine existing module sections and their source-build guide. Keep v1.0.0 Sound-only and all eight additional modules labeled in development. Fix guide overflow and text/focus contrast found during mobile review.

Change type

  • Documentation
  • Website or project tooling

Risk areas

Static copy, anchor navigation and shared article styles. The public download remains v1.0.0. No app runtime, stored data, audio callback, native permission flow or dependencies change.

Verification

python3 -B scripts/check-website.py: passed, five pages and 64 IDs
python3 -B scripts/test_website_tools.py: passed, 11 tests
node --test website/ab-testing.test.js: passed, seven tests
node --check website/script.js: passed
node --check website/ab-testing.js: passed
git diff --check: passed

Real-time audio checklist

  • This change does not touch a HAL callback or callback-owned state.

User-visible evidence

Before: the hero names only Sound, module discovery requires reading the full list, and the guide mixes packaged and source setup.

After: the hero names the broader utility scope, every module has a keyboard-accessible anchor, and packaged/source instructions are separate. Rendered desktop and mobile review covered all five pages at 1100px and 360px, plus homepage checks at 1440px and 390px. Nine keyboard link activations, skip navigation, reduced motion, release labels and FAQ structured-data consistency passed. Guide text and focus contrast are 5.46:1 and 16.28:1; long code stays within the mobile article.

Deployment

Production is rate limited. The existing quality-manager retry must wait until 2026-09-10 08:52 UTC unless Vercel explicitly clears the restriction. Merge to main is authorized. Production retries remain with the existing quality-manager monitor; no manual production build, redeploy or preview promotion is part of this change.

Attribution and license

  • No external code was copied.
  • Existing authorship, copyright and notice information is preserved.
  • Relevant checks were run for the changed website behavior.
  • Unrelated refactoring and formatting are excluded.

Existing repository license and notice files are unchanged.

@vercel

vercel Bot commented Sep 9, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
semper Ready Ready Preview Sep 9, 2026 4:10pm UTC
semper-vmf1 Ready Ready Preview Sep 9, 2026 4:10pm UTC

@coderabbitai

coderabbitai Bot commented Sep 9, 2026

Copy link
Copy Markdown

Warning

Review limit reached

Next included review available in 44 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 3ab82549-e1a6-44f7-83c2-05e528fd8b03

📥 Commits

Reviewing files that changed from the base of the PR and between fb9a3d5 and 017d568.

📒 Files selected for processing (8)
  • website/about.html
  • website/index.html
  • website/llms.txt
  • website/mac-volume-mixer.html
  • website/privacy.html
  • website/sitemap.xml
  • website/styles.css
  • website/terms.html

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@niharnm
niharnm merged commit db697a7 into main Sep 9, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant