mirror of
https://oauth2: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@github.com/m1ngsama/chopsticks.git
synced 2026-06-26 04:34:38 +08:00
104 lines
3.5 KiB
Markdown
104 lines
3.5 KiB
Markdown
# 2.3.0 Release Candidate Testing
|
|
|
|
This branch is the 2.3.0 release candidate. The goal is to prove that the Space
|
|
layout can serve as the project loop for experienced Vim users, not just that
|
|
the mappings work in isolation. Do not tag or publish it as `2.3.0` until the
|
|
checklist below is closed.
|
|
|
|
Inside Vim, run `:ChopsticksBeta` for the compact checklist,
|
|
`:ChopsticksBetaLog` for editable local notes, and `:ChopsticksBetaSession`
|
|
to append a new session block. Run `:ChopsticksHelp` or `:help chopsticks`
|
|
for the native Vim reference.
|
|
|
|
## Install the release candidate
|
|
|
|
Existing checkout:
|
|
|
|
```bash
|
|
cd ~/.vim
|
|
git fetch origin
|
|
git checkout release/2.3.0
|
|
git pull --ff-only
|
|
vim -Nu ~/.vimrc -n -es +'PlugInstall --sync' +'qa!'
|
|
```
|
|
|
|
Fresh checkout:
|
|
|
|
```bash
|
|
git clone --branch release/2.3.0 https://github.com/m1ngsama/chopsticks.git ~/.vim
|
|
ln -sf ~/.vim/.vimrc ~/.vimrc
|
|
vim -Nu ~/.vimrc -n -es +'PlugInstall --sync' +'qa!'
|
|
```
|
|
|
|
Keep local choices in `${XDG_CONFIG_HOME:-~/.config}/chopsticks.vim`:
|
|
|
|
```vim
|
|
let g:chopsticks_profile = 'engineer'
|
|
let g:chopsticks_keymap_style = 'space'
|
|
```
|
|
|
|
Inside Vim, `:ChopsticksConfig` opens that file and `:ChopsticksReload`
|
|
reloads chopsticks after saving it.
|
|
|
|
## Daily test loop
|
|
|
|
Use the release candidate for real editing, not only demos. A session should
|
|
exercise the trained loop until it either feels automatic or exposes friction.
|
|
For each session, record:
|
|
|
|
- The task: project navigation, code edit, grep, git, LSP, Markdown, SSH.
|
|
- The first key you tried when you got stuck.
|
|
- Whether `SPC ?`, `:ChopsticksTutor`, or `:ChopsticksStatus` answered it.
|
|
- Any mapping that felt slow, awkward, surprising, or too easy to mistype.
|
|
- Any documentation line that was wrong, missing, or redundant.
|
|
|
|
`:ChopsticksBetaLog` opens `${XDG_CONFIG_HOME:-~/.config}/chopsticks-2.3.0.md`
|
|
by default. Set `g:chopsticks_beta_log` before loading chopsticks to use a
|
|
different path. Use `:ChopsticksBetaSession` at the start of each real editing
|
|
session so every test has a timestamped block.
|
|
|
|
## Workflows to exercise
|
|
|
|
```text
|
|
SPC SPC find file SPC / grep project
|
|
s + 2ch jump on screen gd / gr definition / references
|
|
SPC rr run current file SPC gs git status
|
|
SPC cf format SPC ca code action
|
|
SPC fc local config SPC ? active cheat sheet
|
|
Ctrl-hjkl windows SPC e sidebar
|
|
:ChopsticksStatus health :ChopsticksConfig preferences
|
|
```
|
|
|
|
Also test the boring path: save, quit, reopen Vim, edit over SSH, open a large
|
|
file, edit Markdown, and use a machine with missing optional tools.
|
|
|
|
## Exit criteria
|
|
|
|
- `s` as the default visible jump still feels worth the native override after
|
|
real editing.
|
|
- No high-frequency action requires remembering an undocumented key.
|
|
- Window/sidebar navigation feels faster than native `<C-w>` only.
|
|
- README, QUICKSTART, `:help chopsticks`, `SPC ?`, and `:ChopsticksTutor`
|
|
teach the same layout.
|
|
- No private wiki or external note is needed to remember the daily loop.
|
|
- `scripts/test.sh quick` and `scripts/test.sh vim` pass locally.
|
|
- The README GIF has been regenerated from `.github/demo.tape` after any public
|
|
key change.
|
|
- The release candidate has been tested on macOS and over SSH on Linux.
|
|
|
|
## Roll back
|
|
|
|
Return to the latest stable release:
|
|
|
|
```bash
|
|
cd ~/.vim
|
|
git fetch origin --tags
|
|
git checkout v2.2.0
|
|
vim -Nu ~/.vimrc -n -es +'PlugInstall --sync' +'qa!'
|
|
```
|
|
|
|
Or keep the code but switch back to the legacy layout:
|
|
|
|
```vim
|
|
let g:chopsticks_keymap_style = 'classic'
|
|
```
|