m1ngsama/chopsticks
1
0
Fork 0
mirror of https://oauth2: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@github.com/m1ngsama/chopsticks.git synced 2026-06-26 05:34:38 +08:00
Code Issues Projects Releases Packages Wiki Activity Actions
chopsticks/BETA.md

3 KiB
Raw Permalink Blame History

Beta Testing

This branch is the v3 beta candidate. Do not tag or publish it as v3.0.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 beta

Existing checkout:

cd ~/.vim
git fetch origin
git checkout release/v3-candidate
git pull --ff-only
vim -Nu ~/.vimrc -n -es +'PlugInstall --sync' +'qa!'

Fresh checkout:

git clone --branch release/v3-candidate 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:

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 beta for real editing, not only demos. 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-beta.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

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
: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.
  • README, QUICKSTART, :help chopsticks, SPC ?, and :ChopsticksTutor teach the same layout.
  • 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 beta has been tested on macOS and over SSH on Linux.

Roll back

Return to the latest stable release:

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:

let g:chopsticks_keymap_style = 'classic'