Skip to content

docs: scrub internal/private-project references from published docs - #116

Merged
gburd merged 1 commit into
masterfrom
chore/scrub-internal-refs
Jul 31, 2026
Merged

docs: scrub internal/private-project references from published docs#116
gburd merged 1 commit into
masterfrom
chore/scrub-internal-refs

Conversation

@gburd

@gburd gburd commented Jul 31, 2026

Copy link
Copy Markdown
Collaborator

Removes references that leaked unpublished sibling projects, local filesystem paths, and agent-process artifacts into the public tree — while preserving the (public) technical substance and all legitimate license attribution.

Removed

  • Private-project names genericized: the DST-inspiration project → "a cooperative-fiber DST runtime"; the LSM/buffer/replication design sources → descriptive equivalents (structure-adaptive LSM, Bitcask, JE-style index-in-WAL + cleaner, quorum-systems toolkit). (test/sim/DESIGN.md, DST-V2-DESIGN.md, docs/design/lsm.md, buffer-swip-aio.md, ROADMAP.md, lab/)
  • Local paths: ~/oss/*, /home/gburd/ws/*, /Users/gregburd/*, a /nix/store TCL path, a build-worktree path.
  • Agent-process artifacts: the agent/test-triage worktree note and every reference to gitignored .agents/*.md working notes (→ "the test-suite maturity plan" / inline).
  • Benchmark hardware genericized (specific bare-metal instance → "bare-metal server").

Kept deliberately (not leaks)

  • The ISC license attribution to libxtc in src/os/os_aio_*.c — proper provenance ("adapted … with the author's permission").
  • The public hegel-c dependency the PBT tests clone.

Comment-only edits to sim_scenario.h / test_sim_crash_recover.c / adaptive.h (no code change); scripts + rank_coverage.py re-verified to parse.

Note: does not touch the OCR (AI-review) system or rewrite history — those are pending separate decisions.

Remove references that leaked unpublished sibling projects, local filesystem
paths, and agent-process artifacts into the public tree, while preserving the
(public) technical substance and all legitimate license attribution:

- Private projects genericized: the DST-inspiration project -> 'a
  cooperative-fiber DST runtime'; the LSM/buffer/replication design sources
  -> descriptive equivalents (structure-adaptive LSM, Bitcask, JE-style
  index-in-WAL + cleaner, quorum-systems toolkit). Affected: test/sim/DESIGN.md,
  DST-V2-DESIGN.md, docs/design/lsm.md, buffer-swip-aio.md, ROADMAP.md, lab/.
- Local paths removed: ~/oss/*, /home/gburd/ws/*, /Users/gregburd/*, a
  /nix/store TCL path, a build worktree path.
- Agent-process artifacts removed: the 'agent/test-triage' worktree note and
  every reference to gitignored .agents/*.md working notes (genericized to
  'the test-suite maturity plan' / inline description).
- Benchmark hardware genericized (specific bare-metal instance -> 'bare-metal
  server').

Kept deliberately: the ISC license attribution to libxtc in src/os/os_aio_*.c
(proper provenance), and the public hegel-c dependency the PBT tests clone.
Comment-only edits to sim_scenario.h / test_sim_crash_recover.c / adaptive.h
(no code change); scripts and rank_coverage.py re-verified to parse.
@gburd
gburd merged commit 2db7dd8 into master Jul 31, 2026
48 of 50 checks passed
@gburd
gburd deleted the chore/scrub-internal-refs branch July 31, 2026 12:53
@github-actions

Copy link
Copy Markdown

Coccinelle convention checks

No new violations. ✅

Resolved since baseline (2) -- update dist/cocci/baseline.txt to lock these in.
rule_mutex_unbalanced|MUTEX_UNBALANCED|src/crypto/mersenne/mt19937db.c|return (ret);
rule_mutex_unbalanced|MUTEX_UNBALANCED|src/mp/mp_register.c|return (ret);

@github-actions

Copy link
Copy Markdown

ABI diff vs v5.3.33 (libabigail — authoritative)

Removed exported symbols (nm -D, _NNNN version suffix normalized)

None.


Advisory: libabigail/nm is the authoritative binary-ABI check; Coccinelle is complementary source-level early warning. See dist/cocci/README.md.

gburd added a commit that referenced this pull request Jul 31, 2026
docs: scrub internal/private-project references from published docs
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