docs: note the intentional density + verbose-comments tradeoff
Add a 5-line style note at the top of lua/tiny-jump/init.lua and mirror the same message in the README under the size-comparison section. The comments in this file are load-bearing — they do the explanatory work that would otherwise be done by helper functions and verbose names. Prevents future-me (or a drive-by PR) from 'cleaning up' the comments as redundant.
This commit is contained in:
2 files changed
+13
-1
No files matched your search
@@ -15,7 +15,7 @@ to the original author for a clean, focused implementation.
|
||||
I forked it because I wanted to pass label highlight attributes directly to
|
||||
`setup()` (instead of having to define a separate highlight group and re-apply
|
||||
it on every colorscheme change). I submitted that as a
|
||||
(PR)[https://github.com/yorickpeterse/nvim-jump/pull/8] but it was declined,
|
||||
[PR](https://github.com/yorickpeterse/nvim-jump/pull/8) but it was declined,
|
||||
which is the maintainer's right — the upstream plugin is explicitly considered
|
||||
feature-complete.
|
||||
|
||||
@@ -43,6 +43,13 @@ cursor-proximity sorting, and two-char labels for overflow matches, this fork is
|
||||
slightly _smaller_ than upstream — and an order of magnitude smaller than every
|
||||
other alternative on this list.
|
||||
|
||||
### A note on style
|
||||
|
||||
The code is intentionally dense. Comments are thorough by design — they do the
|
||||
explanatory work that would otherwise be done by helper functions and verbose
|
||||
names. If you're reading or editing `lua/tiny-jump/init.lua`, read the comments
|
||||
first. Don't "clean them up" — they're the docs.
|
||||
|
||||
## Requirements
|
||||
|
||||
- Neovim 0.11.0 or newer.
|
||||
|
||||
Reference in new issue
Block a user