summaryrefslogtreecommitdiff
path: root/locales/help_docs/en.yml
diff options
context:
space:
mode:
author魏曹先生 <1992414357@qq.com>2026-01-03 15:17:56 +0800
committer魏曹先生 <1992414357@qq.com>2026-01-03 15:17:56 +0800
commit7f3e51cf19e23292ab2087f521408c70c92f12fe (patch)
tree227b5d8e7571367113d3a4084b46755db41e13f3 /locales/help_docs/en.yml
parent6de928360b8be82e06b7eaea67654d557283511a (diff)
Update track command help text to clarify its conceptual model
The help text for `jv track` has been rewritten to emphasize its role as a declaration of fact rather than a simple upload/download operation. The new text explains the three scenarios: creation (when a file is untracked), update (when you hold the file), and synchronization (when you don't hold the file). The Chinese locale has been updated accordingly.
Diffstat (limited to 'locales/help_docs/en.yml')
-rw-r--r--locales/help_docs/en.yml31
1 files changed, 20 insertions, 11 deletions
diff --git a/locales/help_docs/en.yml b/locales/help_docs/en.yml
index 02d371c..7b2d200 100644
--- a/locales/help_docs/en.yml
+++ b/locales/help_docs/en.yml
@@ -381,18 +381,27 @@ jv:
- File's version in `ref`
track: |
- **Track or Pull Files**
+ **Track Files to Latest Fact**
**Usage**: jv track <FILE_PATH>
- **Example**: jv track src/main.rs
- For new files:
- Create and upload the "First Version", then automatically hold them
- For *held* files:
- Upload new versions to the upstream vault to update to the latest version
- For *unheld* or *non-exist* files:
- Download or update local file versions to the latest
+ It is not uploading, nor downloading,
+ but a declaration of the result regarding [[cyan]]"which version should be considered fact"[[/]].
- Tracking files is the basic operation of version control, ensuring your upstream and local files are always up to date.
+ **Creation**
+ When there is an untracked file in the workspace, that file does not yet exist in the recognized fact.
+ Executing track will create the factual version of this file, write it to your sheet, and grant you editing rights.
+ At this point, you are **the author of this fact**.
+
+ **Update**
+ When you hold a file and edit based on the current latest fact,
+ the version in your workspace will be considered the new latest fact.
+ Executing track will **update this fact to the upstream**.
+
+ **Synchronization**
+ When you do not hold the file, edit based on outdated facts, or the file does not exist locally,
+ your modifications do not have factual validity; everything follows the upstream latest version.
+ Executing track will **synchronize the upstream fact to local**.
+ To overwrite local modifications, you must explicitly specify `--overwrite`.
hold: |
**Hold Files: Obtain File Edit Rights from Upstream Vault**
@@ -417,8 +426,8 @@ jv:
move: |
**Move Mapping**
**Usage**:
- jv move <mapping> <target_mapping> - Modify upstream mapping
- jv move <mapping> --erase - Erase upstream mapping
+ jv move <MAPPING> <TARGET_MAPPING> - Modify upstream mapping
+ jv move <MAPPING> --erase - Erase upstream mapping
**Examples**:
jv move draft/character.png done/character.png - Move mapping