diff options
| author | 魏曹先生 <1992414357@qq.com> | 2026-01-03 15:17:56 +0800 |
|---|---|---|
| committer | 魏曹先生 <1992414357@qq.com> | 2026-01-03 15:17:56 +0800 |
| commit | 7f3e51cf19e23292ab2087f521408c70c92f12fe (patch) | |
| tree | 227b5d8e7571367113d3a4084b46755db41e13f3 /locales/help_docs/en.yml | |
| parent | 6de928360b8be82e06b7eaea67654d557283511a (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.yml | 31 |
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 |
