Skip to content

Description standard: rewrite 734 thin descriptions after source review; remove 5 apps - #35

Merged
raelsei merged 7 commits into
mainfrom
agent/writing-standard
Nov 8, 2026
Merged

raelsei merged 7 commits into
mainfrom
agent/writing-standard

Conversation

@raelsei

@raelsei raelsei commented Nov 8, 2026

Copy link
Copy Markdown
Member

Change

From the content/writing-standard branch (six commits by the workstation that commits as Abdulkadir Polat), merged with current main. Details are in the two new docs/VERIFICATION.md entries dated 2026-11-08.

  • House style in CONTRIBUTING.md ("Writing the description") and src/lib/writing.ts, which rejects the mechanical failures (review-process wording, puffery, more than two attributions, sentences over 40 words, uniform sentence lengths, imperative summaries, a body that names no product from alternativeTo) on every record verified from 2026-11-08. Older records keep loading until they are rewritten.
  • 734 descriptions rewritten (20-record pilot, then three waves, most-installed first). Each fact was taken from the project's own site, README, release notes or release files and re-checked by a second reviewer.
  • Record facts that changed: 44 license identifiers (mostly to -or-later), 44 apps labelled Unmaintained, freeDownload: false for VoiceInk, SaneHosts, SaneClick and SaneClip (paid after a trial), Nativ's repository moved to Neywa-Labs/nativ, Buzz's Mac download is on SourceForge, 16 websites corrected.
  • Removed and added to research/held-out.json: Numi, Chatbox, Orkas, Sapphire, Notarize (reasons in the held-out list).

Merge with main: one conflict in docs/VERIFICATION.md; both entries kept, newest first. The Homebrew lines are identical to #32.

Verification

Merged onto current main locally: bun run validate (1,869 apps), bun run sync (no changes), bun run check:generated, bun test (24), bun run check (0 errors), bun run build (2,061 pages), bun run check:links (178,732 links), bun run check:homebrew (571 casks). Spot checks against the projects' own pages: AltTab (Pro tier), Buzz (SourceForge, Apple silicon only after 1.4.5), Nativ (repository moved).

Undo

Revert this commit; the five removed apps come back by deleting their research/held-out.json entries too.

@raelsei
raelsei merged commit a729212 into main Nov 8, 2026
1 check passed
@raelsei
raelsei deleted the agent/writing-standard branch November 8, 2026 21:05
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.

2 participants