diff options
| author | Justin M. Keyes <justinkz@gmail.com> | 2017-08-03 10:13:43 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2017-08-03 10:13:43 +0200 |
| commit | 5cc4ea38c01e5307a7bfa7b2e238d69e1062c194 (patch) | |
| tree | 536633af92e2e1c850fb4eee9f2b73842f6c96e2 /runtime/doc/develop.txt | |
| parent | 8160a0e04244d054c4555a5a1af09963470964a1 (diff) | |
| parent | 29f44aab5a52747c36bac27cbe8e06efb82eba1d (diff) | |
| download | rneovim-5cc4ea38c01e5307a7bfa7b2e238d69e1062c194.tar.gz rneovim-5cc4ea38c01e5307a7bfa7b2e238d69e1062c194.tar.bz2 rneovim-5cc4ea38c01e5307a7bfa7b2e238d69e1062c194.zip | |
Merge #7105 from justinmk/doc-tui
Diffstat (limited to 'runtime/doc/develop.txt')
| -rw-r--r-- | runtime/doc/develop.txt | 20 |
1 files changed, 13 insertions, 7 deletions
diff --git a/runtime/doc/develop.txt b/runtime/doc/develop.txt index 7fd1f90173..5d5523e73f 100644 --- a/runtime/doc/develop.txt +++ b/runtime/doc/develop.txt @@ -63,12 +63,6 @@ NVIM IS... WELL DOCUMENTED *design-documented* - Documentation should be comprehensive and understandable. Use examples. - Don't make the text unnecessarily long. Less documentation means that an item is easier to find. -- Do not prefix doc-tags with "nvim-". Use |vim_diff.txt| to document - differences from Vim. The {Nvim} annotation is also available - to mark a specific feature. No other distinction is necessary. -- If a feature is removed, delete its doc entry and move its tag to - |vim_diff.txt|. -- Move deprecated features to |deprecated.txt|. NVIM IS... HIGH SPEED AND SMALL IN SIZE *design-speed-size* @@ -113,7 +107,7 @@ include the kitchen sink... but it's good for plumbing." ============================================================================== -Developer guidelines *dev-help* +Developer guidelines *dev* JARGON *dev-jargon* @@ -192,6 +186,18 @@ defined if a valid external Python host is found. That works well with the Python host isn't installed then the plugin will "think" it is running in a Vim compiled without the |+python| feature. +DOCUMENTATION *dev-doc* + +- Do not prefix help tags with "nvim-". Use |vim_diff.txt| to document + differences from Vim; no other distinction is necessary. +- If a Vim feature is removed, delete its help section and move its tag to + |vim_diff.txt|. +- Move deprecated features to |deprecated.txt|. +- Use consistent language. + - "terminal" in a help tag always means "the embedded terminal emulator", not + "the user host terminal". + - Use "tui-" to prefix help tags related to the host terminal, and "TUI" + in prose if possible. API *dev-api* |