docs: add force-with-lease concept article - #97
Merged
Conversation
Contributor
|
🚀 Web preview: https://preview-97.treq-9zy.pages.dev |
cursor
Bot
force-pushed
the
cursor/force-with-lease-article-5451
branch
from
July 27, 2026 11:31
93e1a3e to
bb00d16
Compare
Ziinc
marked this pull request as ready for review
August 15, 2026 18:42
Explain --force-with-lease as a conditional force push, cover syntax variants, the background-fetch hole, and --force-if-includes. Co-authored-by: Ziinc <Ziinc@users.noreply.github.com>
Fix the broken Next Steps path, add in-body outbound links, and wire inbound links from related rebase, push, stack, and auto-rebase docs. Co-authored-by: Ziinc <Ziinc@users.noreply.github.com>
Explain that workspace Push and Sync use the same expected-tip check as git push --force-with-lease, including the shared background-fetch limit. Co-authored-by: Ziinc <Ziinc@users.noreply.github.com>
cursor
Bot
force-pushed
the
cursor/force-with-lease-article-5451
branch
from
August 15, 2026 18:44
be153f8 to
c53cd79
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a learn/concepts article on
git push --force-with-lease, rewritten from research notes into the treq house voice. Rebased onto currentmain(resolved Next Steps conflict in merge vs rebase). Treq Push and Sync apply the same lease check without the Git flag.Contents
--force<refname>:<expect>for CI--force-if-includesmitigation and its no-op with an explicit expect hash--forceon the Push buttonRebase
mainmerge-vs-rebase.mdx