Skip to content

docs(system-design): add coordination and consensus guide - #44

Merged
shalshcode08 merged 4 commits into
mainfrom
codex/coordination-consensus-leases-locks
Aug 2, 2026
Merged

shalshcode08 merged 4 commits into
mainfrom
codex/coordination-consensus-leases-locks

Conversation

@shalshcode08

Copy link
Copy Markdown
Owner

Summary\n\n- add a standalone, language-neutral Topic 8 guide to coordination, consensus, Raft, leader election, leases, fencing tokens, distributed locks, semaphores, barriers, and coordination services\n- include detailed leader-elected scheduler and fenced inventory allocator designs with failure timelines and resource-side correctness rules\n- cover production architecture, membership changes, snapshots, observability, security, performance, failure recovery, testing, exercises, interview Q&A, cheat sheet, and primary official references\n- register the guide in the System Design and Distributed Systems navigation manifest\n\n## Scope\n\nThis pull request changes only:\n\n- manifest.json\n- src/content/systemdesign/coordination-consensus-leases-locks.html\n\nNo tests, styling, shared design files, or TOPICS.md statuses were changed.\n\n## Research\n\nPrimary sources include the extended Raft paper and USENIX publication, the official Raft resource site, Paxos Made Simple from Microsoft Research, official etcd API guarantees and concurrency APIs, Apache ZooKeeper and Curator recipes, Kubernetes Lease and coordinated leader election documentation, and PostgreSQL locking and uniqueness documentation.\n\n## Validation\n\n- npx prettier --check manifest.json src/content/systemdesign/coordination-consensus-leases-locks.html\n- npm test\n- npm run build\n- git diff --check\n- scope check: exactly one new topic file plus manifest.json\n- footer check: exact July 2026 knowledge-base footer present once\n- no em dash found in new topic or manifest entry\n\n## Notes\n\nThe documentation remains framework-neutral, uses pseudocode first for algorithms, and uses a small TypeScript example only to demonstrate cancellation and fencing boundaries. TOPICS.md remains Pending until this pull request is merged.

Co-authored-by: Codex <codex@openai.com>
@shalshcode08 shalshcode08 added documentation Improvements or additions to documentation codex codex-automation labels Aug 2, 2026
Co-authored-by: Codex <codex@openai.com>
@shalshcode08
shalshcode08 marked this pull request as ready for review August 2, 2026 08:57
shalshcode08 and others added 2 commits August 2, 2026 14:28
Co-authored-by: Codex <codex@openai.com>
Co-authored-by: Codex <codex@openai.com>
@shalshcode08
shalshcode08 merged commit 82cbb4e into main Aug 2, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

codex codex-automation documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant