diff options
| author | Justin M. Keyes <justinkz@gmail.com> | 2023-06-19 02:24:44 -0700 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2023-06-19 02:24:44 -0700 |
| commit | cee981bf09c81ab4b2fe6facf45076ea4bac46a5 (patch) | |
| tree | ccdf43826f362a560eadb6518a399f35b192dcd4 /runtime/doc/develop.txt | |
| parent | 8c9dab3e0d788d44c8a2fee83a6193f5955c814e (diff) | |
| download | rneovim-cee981bf09c81ab4b2fe6facf45076ea4bac46a5.tar.gz rneovim-cee981bf09c81ab4b2fe6facf45076ea4bac46a5.tar.bz2 rneovim-cee981bf09c81ab4b2fe6facf45076ea4bac46a5.zip | |
docs #22363
Co-authored by: zeertzjq <zeertzjq@outlook.com>
Co-authored by: Steven Todd McIntyre II <114119064+stmii@users.noreply.github.com>
Co-authored by: nobe4 <nobe4@users.noreply.github.com>
- docs: mention --luadev-mod to run with lua runtime files
When changing a lua file in the ./runtime folder, a new contributor
might expect changes to be applied to the built Neovim binary.
Diffstat (limited to 'runtime/doc/develop.txt')
| -rw-r--r-- | runtime/doc/develop.txt | 17 |
1 files changed, 14 insertions, 3 deletions
diff --git a/runtime/doc/develop.txt b/runtime/doc/develop.txt index b090fd4f09..891b068051 100644 --- a/runtime/doc/develop.txt +++ b/runtime/doc/develop.txt @@ -130,10 +130,14 @@ DOCUMENTATION *dev-doc* (docstrings, user manual, website materials, newsletters, …). Don't mince words. Personality and flavor, used sparingly, are welcome--but in general, optimize for the reader's time and energy: be "precise yet concise". - - See https://developers.google.com/style/tone - Prefer the active voice: "Foo does X", not "X is done by Foo". -- Start function docstrings with present tense ("Gets"), not imperative - ("Get"). This tends to reduce ambiguity and improve clarity. > + - "The words you choose are an essential part of the user experience." + https://developer.apple.com/design/human-interface-guidelines/foundations/writing/ + - "...without being overly colloquial or frivolous." + https://developers.google.com/style/tone +- Write docstrings (as opposed to inline comments) with present tense ("Gets"), + not imperative ("Get"). This tends to reduce ambiguity and improve clarity + by describing "What" instead of "How". > GOOD: /// Gets a highlight definition. BAD: @@ -272,6 +276,12 @@ See also |dev-naming|. - mimic the pairs() or ipairs() interface if the function is intended to be used in a "for" loop. +Interface conventions ~ + +- When accepting a buffer id, etc., 0 means "current buffer", nil means "all + buffers". Likewise for window id, tabpage id, etc. + - Examples: |vim.lsp.codelens.clear()| |vim.diagnostic.enable()| + API DESIGN GUIDELINES *dev-api* @@ -346,6 +356,7 @@ Use consistent names for {noun} (nouns) in API functions: buffer is called Do NOT use these deprecated nouns: - buffer + - callback Use on_foo instead - command - window |