Skip to content

Add links to the fundamentals briefs - #9

Merged
pinebit merged 3 commits into
mainfrom
fundamentals-links
Oct 8, 2026
Merged

pinebit merged 3 commits into
mainfrom
fundamentals-links

Conversation

@pinebit

@pinebit pinebit commented Oct 8, 2026

Copy link
Copy Markdown
Owner

Adds external links to the algorithms, database, networking and os briefs and removes their bold formatting, following the linking style of golang.md, system.md and distributed.md.

Briefs

  • Links go to official sources where they exist: PostgreSQL and MySQL 8.4 docs, redis.io, MongoDB, Cassandra, RFCs on rfc-editor.org, MDN, man7.org man pages and docs.kernel.org. General CS terms link to Wikipedia, cp-algorithms or the USACO Guide. Cross-topic mentions link to the owner file (CDC → distributed.md, fsync → os.md, goroutines and netpoller → golang.md).
  • Wording is unchanged except for these corrections:
    • algorithms: Master theorem cases need polynomial gaps, and the larger case a regularity condition.
    • database: trigram search can use GIN or GiST; IS NULL in WHERE doesn't turn a LEFT JOIN into an inner join; MongoDB's w: "majority" default has an arbiter exception; only non-recursive CTEs are inlined; two single-bullet concepts are now paragraphs.
    • networking: SYN timeout is ~131 s since Linux 6.5 (~127 s before); a lost packet "can" add ≥ 200 ms; the Nagle/delayed-ACK stall is ~40 ms on Linux, ~200 ms on Windows.
    • os: minor and major page fault definitions; overcommit separated from first-touch allocation; page cache is "usually" reclaimed first; splice needs a pipe; CPU field names formatted as code.
  • system.md: two Redis links that only redirect now point to their canonical URLs.
  • distributed.md: semi-sync and binlog now link the MySQL docs instead of MariaDB and Debezium pages.

Link checker

scripts/check_links.py retries a 403 once with urllib's default User-Agent. dev.mysql.com rejects the descriptive agent that Wikipedia requires.

Checks

  • python3 scripts/check_links.py on the four briefs, system.md and distributed.md: 0 problems.
  • python3 scripts/lint_briefs.py: 0 problems.
  • zensical build --clean --strict: no issues.

🤖 Generated with Claude Code

pinebit and others added 3 commits October 8, 2026 06:44
dev.mysql.com rejects the descriptive User-Agent that Wikipedia requires
but accepts urllib's default, so a 403 is retried once without it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Add external links to algorithms, database, networking and os, remove
bold, and fix facts flagged in review.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@pinebit
pinebit merged commit 028829e into main Oct 8, 2026
1 check 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