From 9fc3255238d6ebaa9877e7329f771deceff23c0e Mon Sep 17 00:00:00 2001 From: Martin von Zweigbergk Date: Sat, 16 Nov 2024 14:08:48 -0800 Subject: [PATCH] docs: try to clarify that changes are not a first-class concept --- docs/glossary.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/glossary.md b/docs/glossary.md index 560d969c8b..dc9eae9485 100644 --- a/docs/glossary.md +++ b/docs/glossary.md @@ -44,7 +44,9 @@ local Git branch corresponds to a `jj` bookmark. ## Change -A change is a commit as it [evolves over time](#rewrite). +A change is a commit as it [evolves over time](#rewrite). Changes themselves +don't exist as an object in the data model; only the change ID does. The change +ID is a property of a commit. ## Change ID @@ -53,7 +55,7 @@ A change ID is a unique identifier for a [change](#change). They are typically them as a sequence of 12 letters in the k-z range, at the beginning of a line. These are actually hexadecimal numbers that use "digits" z-k instead of 0-9a-f. -For the git backend, Change IDs are currently maintained only locally and not +For the Git backend, Change IDs are currently maintained only locally and not exchanged via push/fetch operations. ## Commit