Skip to content

docs(web): document v0.7.0 features on the website - #172

Merged
jatinkrmalik merged 2 commits into
mainfrom
docs/website-v0.7.0-features
Jul 2, 2026
Merged

docs(web): document v0.7.0 features on the website#172
jatinkrmalik merged 2 commits into
mainfrom
docs/website-v0.7.0-features

Conversation

@jatinkrmalik

Copy link
Copy Markdown
Member

Summary

Brings the website up to date with the features shipping in v0.7.0. A multi-agent audit checked all five features shipped since v0.6.2; each finding was independently verified. Result: 4 of 5 needed website work — Homebrew (#157/#159) was already fully covered, so it's untouched.

Kept separate from the version-bump PR (#171) so the release PR stays clean. Branches from main (no version-string changes here).

What changed

Feature Was Change
Custom vocabulary (#169) missing New page features/custom-vocabulary.md + landing grid card + JSON-LD
Usage statistics (#148/#168/#170) missing New page features/usage-stats.md + landing grid card + JSON-LD + gallery entry
Hotkey presets + custom recording (#139) partial / stale Rewrote stale "key combination" copy in fully-configurable.md; documented the Record/custom-key flow + added Right Control preset in push-to-talk.md; updated the FAQ
Audio input device (#156) thin Expanded fully-configurable.md (System Default, non-invasive pinning, auto-fallback on disconnect, Refresh Devices) + JSON-LD line
Homebrew (#157/#159) ✅ covered No change (verified)

📸 Screenshots I need from you

Two images are referenced but not yet committed. Both are marked in the source with <!-- SCREENSHOT PLACEHOLDER ... --> comments. Drop the PNGs into web/static/screenshots/ with these exact names:

Filename Capture Used by
settings-stats.png Settings → Stats tab (ideally with real usage so it's not all zeros) usage-stats.md + screenshots gallery
settings-vocabulary.png Settings → General, scrolled to the Custom Vocabulary section (a few example terms typed in) custom-vocabulary.md

Target size: 1344 × 1260 px (matches the existing settings-*.png). Capture with ⌘⇧4 → Space → click the Settings window; if the size differs I'll rescale. Until they're added, those two <img> tags 404 — everything else renders fine.

Verification

  • hugo build succeeds (exit 0); both new feature pages render; home grid shows both new cards; JSON-LD parses (16 entries).
  • No version strings touched (that's chore: bump version to 0.7.0 #171).

Not done (by design)

  • Optional settings-debug.png gallery entry (Debug tab exists but was never in the gallery) — unrelated to v0.7.0; say the word and I'll add it.

Adds website coverage for features shipped since v0.6.2 (audit found 4 of
5 uncovered; Homebrew was already fully covered, left untouched):

- New feature pages: Custom Vocabulary (#169) and Usage Statistics
  (#148/#168/#170), each with a landing-page grid card.
- Landing JSON-LD featureList: add custom vocabulary, local usage stats,
  and selectable audio input device (#156).
- Hotkey presets + custom recording (#139): fix stale "key combination"
  copy in fully-configurable.md, document the Record/custom-key capture
  and add the Right Control preset in push-to-talk.md, and update the FAQ.
- Audio input device (#156): expand fully-configurable.md (System Default,
  non-invasive pinning, auto-fallback on disconnect, Refresh Devices).
- Screenshots gallery: add a Stats tab entry.

Two screenshots still needed from a real capture (marked with SCREENSHOT
PLACEHOLDER comments): settings-stats.png and settings-vocabulary.png.
Verified with `hugo` (build succeeds; new pages render; JSON-LD valid).
@github-actions github-actions Bot added the web label Jul 2, 2026
Features grid:
- Switch from a fixed 4-col grid (which left 2 orphan cards hanging and,
  via grid-auto-rows:1fr, forced every row to the tallest card's height)
  to a centered flex-wrap layout: uniform card heights, the short last
  row centers, and 4/2/1 columns at desktop/tablet/mobile.
- Apple-style polish: icon squircle tiles, tighter 1–2 line copy on every
  card, softer corners, refined heading type, gentler hover.

Mobile hero:
- The 380px mockup forced the hero column wider than small viewports,
  clipping the subtext/pills/buttons. Reset min-width and clip the
  decorative mockup so nothing overflows below ~420px.

SEO:
- og:type now "article" for content pages (was always "website").
- Enriched the home and features-list meta descriptions.
- Verified across all 18 pages: unique titles, one <h1> each, descriptions
  present, all <img> have alt, sitemap includes the new pages.

Screenshots: add settings-stats.png and settings-vocabulary.png (referenced
by the new feature pages) and refresh settings-general.png.
@jatinkrmalik
jatinkrmalik merged commit 8c5e1dc into main Jul 2, 2026
3 checks passed
@jatinkrmalik
jatinkrmalik deleted the docs/website-v0.7.0-features branch August 22, 2026 05:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant