Skip to content

docs(ghostty): add libghostty fork maintenance rules - #76

Merged
nek0der merged 2 commits into
mainfrom
docs/libghostty-fork
Sep 15, 2026
Merged

nek0der merged 2 commits into
mainfrom
docs/libghostty-fork

Conversation

@nek0der

@nek0der nek0der commented Sep 15, 2026

Copy link
Copy Markdown
Owner

Summary

Adds docs/libghostty-fork.md, a standing document for how we maintain the
libghostty fork: why it exists, what a patch must carry, how we rebase, and
how we retire one. Brings the existing fork patch up to those rules by
recording its class and retirement condition in its commit message. No
tracked source changes — the submodule bump rewrites a commit message and
leaves the tree byte-identical.

Related issue

Skip.

How verified

  • git check-ignoredocs/libghostty-fork.md is not ignored; local notes
    directly under docs/ still are.
  • Every command in the Health section runs against this checkout and returns
    the expected values: one patch carried, 133 commits behind upstream.
  • git rev-parse — the submodule's new tip has the same tree as the old one,
    so no build output can change.
  • The state pinned before the rewrite stays reachable through the
    pin/2026-09-06 tag, pushed to the fork.
  • make lint — Rust and Swift checks pass with zero violations.
  • make test — Rust, XCTest, and Swift Testing suites all pass.

Screenshots / video

Skip.

Checklist

  • make lint clean locally
  • make test passes
  • make review-core passes (its own CI job; make test does not cover it)
  • Tests added or updated where applicable
  • User-facing strings added to Localizable.xcstrings with both en and ja
  • Verified manually on macOS 26 (Tahoe) — see "How verified" above
  • Code comments are in English

@github-actions github-actions Bot added documentation Improvements or additions to documentation area: build labels Sep 15, 2026
@nek0der
nek0der force-pushed the docs/libghostty-fork branch from 3aadabe to 07b1f0e Compare September 15, 2026 15:26
@nek0der
nek0der enabled auto-merge (squash) September 15, 2026 15:34
@nek0der
nek0der merged commit 558d98c into main Sep 15, 2026
13 checks passed
@nek0der
nek0der deleted the docs/libghostty-fork branch September 15, 2026 15:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: build documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant