Skip to content

revise(post): tsundoku in the new voice + accuracy refresh (#303 sibling)#326

Merged
williamzujkowski merged 3 commits into
mainfrom
post/tsundoku-voice
Jul 20, 2026
Merged

revise(post): tsundoku in the new voice + accuracy refresh (#303 sibling)#326
williamzujkowski merged 3 commits into
mainfrom
post/tsundoku-voice

Conversation

@williamzujkowski

Copy link
Copy Markdown
Owner

Wit-pass rewrite of the tsundoku post ("3,534 Books, and the Website I Built Instead of Reading Any of Them"), matching the new house voice with the oklch post as the gold-standard exemplar. Codex trim pass applied.

  • Accuracy refresh: reconciled all counts to the current live site — 3,584 books / 28 categories (a genuine 29→28 recategorization via DDC/LCC, explained in-post) / 1,649 authors; fixed a bonus factcheck error (test count was 70, actually 70 Vitest + 460 pytest = 530).
  • Codex notes applied: "six primary sources + Wikidata backstop" framing, doc-bug detour compressed 44%, "what it built"→"what I built", one too-visible wink replaced, HathiTrust "settles"→"gives a better rights signal."
  • Original post also had 5 stale technical claims (Pagefind→hand-rolled search, Astro 6→7, etc.) that the rewrite corrected against live code.

Full blog-pre-publish gate: clean. Build green (200 pages).

🤖 Generated with Claude Code

williamzujkowski and others added 2 commits July 20, 2026 00:44
Reframes the tsundoku bookshelf post around its own self-aware tagline
("because buying books and not reading them is a lifestyle") and adds
dry, verified wit in place of the straight/informative original.

Re-verified every number against the live repo (gh api): 3,534 books,
29 categories, 1,615 authors, 35 genres, and the free-reading link
counts. Corrects several claims that drifted since the original draft:
search is a hand-rolled index (not Pagefind), reading progress is a
build-time CSV merge (not localStorage), Gutenberg/LibriVox now go
through Gutendex/JSON APIs, category assignment is DDC/LCC-derived
(not manual), and Astro is on 7 (not 6). Documents the ranked
provenance-merge conflict system and flags the repo's own "42
categories" vs. 29 documentation mismatch (tsundoku#228). Adds a
Sources section.

Ran the full blog-pre-publish gate (overlap, factcheck, llm-tells,
nda-check, argument-shape) — zero HIGH findings; two dramatic
em-dashes swapped for period/colon per the llm-tells pass.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…, tighten voice

Adversarial-review pass on the tsundoku post:
- Numbers were stale (3,534/29/1,615) vs. the live site's current
  3,584/28/1,649; category count actually dropped 29->28 from a
  recategorization, not just growth. Reconciled every book/category/
  author/link-count figure against gh api + the live site, including
  the CI test-count row (was wrong on both axes: 70/35/35 vs. actual
  530 total, 70 Vitest / 460 pytest). Added one light aside that the
  count keeps climbing.
- Reframed "six enrichment APIs" consistently as "six primary sources,
  plus Wikidata as a backstop" across the description, prose, and
  metrics table, so the Wikidata paragraph stops undercutting the
  headline.
- Fixed "what it built" -> "what I built".
- Cut the "which feels appropriate for a post about a backlog" wink
  for a flatter "The headline aged before the rewrite did."
- Compressed the documentation-bug paragraph (~44% shorter) so the
  post reaches the pipeline faster.
- Cleaned up muddy phrasing ("no argument needed for buying yet
  another copy", the HathiTrust copyright question) per review notes.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

Link Validation Results

  • Total Links: 993
  • Broken Links: 55
  • Status: failed
View Full Report

Link Validation Report

Generated: 2026-07-20 05:30:08

Executive Summary

  • Total Links Checked: 1492
  • Valid Links: 1120 (75.1%)
  • Broken Links: 70 (4.7%)
  • Redirects: 0
  • Requires Manual Review: 49
  • Auto-Fixable: 16

Issue Breakdown

Issue Type Count Percentage
None 1120 75.1%
connection_error 190 12.7%
http_429 1 0.1%
http_418 3 0.2%
http_403 97 6.5%
http_401 3 0.2%
not_found 46 3.1%
dns_error 24 1.6%
timeout 4 0.3%
http_400 4 0.3%

Top Affected Domains

Domain Broken Links Total Links
doi.org 15 32
vault.example.com 5 5
raw.githubusercontent.com 4 6
github.com 2 150
www.nature.com 2 10
azure.microsoft.com 2 5
www.intelrealsense.com 2 2
www.jpmorgan.com 2 2
www.whitehouse.gov 2 4
wazuh-manager:55000 2 2

Repair Statistics

  • High Confidence Fixes: 16
  • Medium Confidence Fixes: 5
  • Low Confidence Fixes: 0
  • No Fix Available: 49

Files with Most Issues

File Broken Links Total Links
2025-09-01-self-hosted-bitwarden-migration-guide.md 8 19
2025-09-20-iot-security-homelab-owasp.md 7 26
2025-09-14-threat-intelligence-mitre-attack-dashboard.md 6 25
2025-08-09-ai-cognitive-infrastructure.md 6 32
2025-11-05-siem-homelab-wazuh-graylog-comparison.md 5 23
2024-08-27-zero-trust-security-principles.md 3 15
2025-11-19-promsketch-prometheus-optimization.md 3 20
2024-09-25-gvisor-container-sandboxing-security.md 3 47
2025-03-10-raspberry-pi-security-projects.md 3 8
2024-07-16-sustainable-computing-carbon-footprint.md 2 31

@williamzujkowski
williamzujkowski enabled auto-merge (squash) July 20, 2026 05:30
@williamzujkowski
williamzujkowski merged commit 4605e08 into main Jul 20, 2026
10 checks passed
@github-actions

Copy link
Copy Markdown

Link Validation Results

  • Total Links: 993
  • Broken Links: 55
  • Status: failed
View Full Report

Link Validation Report

Generated: 2026-07-20 05:34:00

Executive Summary

  • Total Links Checked: 1492
  • Valid Links: 1122 (75.2%)
  • Broken Links: 70 (4.7%)
  • Redirects: 0
  • Requires Manual Review: 49
  • Auto-Fixable: 16

Issue Breakdown

Issue Type Count Percentage
None 1122 75.2%
connection_error 191 12.8%
http_429 1 0.1%
http_403 97 6.5%
http_401 3 0.2%
not_found 46 3.1%
dns_error 24 1.6%
timeout 4 0.3%
http_400 4 0.3%

Top Affected Domains

Domain Broken Links Total Links
doi.org 15 32
vault.example.com 5 5
raw.githubusercontent.com 4 6
github.com 2 150
www.nature.com 2 10
azure.microsoft.com 2 5
www.intelrealsense.com 2 2
www.jpmorgan.com 2 2
www.whitehouse.gov 2 4
wazuh-manager:55000 2 2

Repair Statistics

  • High Confidence Fixes: 16
  • Medium Confidence Fixes: 5
  • Low Confidence Fixes: 0
  • No Fix Available: 49

Files with Most Issues

File Broken Links Total Links
2025-09-01-self-hosted-bitwarden-migration-guide.md 8 19
2025-09-20-iot-security-homelab-owasp.md 7 26
2025-09-14-threat-intelligence-mitre-attack-dashboard.md 6 25
2025-08-09-ai-cognitive-infrastructure.md 6 32
2025-11-05-siem-homelab-wazuh-graylog-comparison.md 5 23
2024-08-27-zero-trust-security-principles.md 3 15
2025-11-19-promsketch-prometheus-optimization.md 3 20
2024-09-25-gvisor-container-sandboxing-security.md 3 47
2025-03-10-raspberry-pi-security-projects.md 3 8
2024-07-16-sustainable-computing-carbon-footprint.md 2 31

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