vim-doge

Any fool can write code that a computer can understand. Good programmers write code that humans can understand. -- Martin Fowler, 1999

We all love documentation because it makes our codebases easier to understand, yet no one has time to write it in a good and proper way.

Vim-doge is a (Do)cumentation (Ge)nerator which will generate a proper documentation skeleton based on certain expressions (mainly functions). Simply put your cursor on a function, press d, jump quickly through TODO items using and to quickly add descriptions and go on coding!

Table of Contents

• Table of Contents
• Supported languages and doc standards
• Getting started
• Configuration
  • Choosing a different doc standard
  • Options
    • g:doge_install_path
    • g:doge_enable_mappings
    • g:doge_mapping
    • g:doge_filetype_aliases
    • g:doge_buffer_mappings
    • g:doge_mapping_comment_jump_forward
    • g:doge_mapping_comment_jump_backward
    • g:doge_comment_interactive
    • g:doge_comment_jump_wrap
    • g:doge_comment_jump_modes
• Commands
  • :DogeGenerate {doc_standard}
• Language-specific configuration
  • JavaScript
  • PHP
  • Python
  • Doxygen
• Headless mode
• Help
• Contributing
  • Tree sitter
• Development
  • Environment setup
  • Helper
  • Testing locally
• Motivation
• Supporting vim-doge
• Alternative projects
• License

Supported languages and doc standards

Every language that has a documentation standard should be supported by vim-doge.

Is your favorite language not supported? [Suggest a new language][suggest-language] :tada:

Is your favorite doc standard not supported? [Suggest a new doc standard][suggest-doc-standard] :tada:

Getting started

Using plug:

• Plug 'kkoomen/vim-doge', { 'do': { -> doge#install() } }

Using vim-pack:

• git clone --recursive --depth 1 https://github.com/kkoomen/vim-doge ~/.vim/pack/*/start/vim-doge
• Open Vim and run :call doge#install()

Using Pathogen:

• git clone --recursive --depth 1 https://github.com/kkoomen/vim-doge ~/.vim/bundle/vim-doge
• Open Vim and run :call doge#install()

Using Vundle:

• Plugin 'kkoomen/vim-doge'
• Open Vim and run :call doge#install()

Using packer.nvim:

use {
  'kkoomen/vim-doge',
  run = ':call doge#install()'
}

Using LazyVim:

• Add plugin config to lua plugins folder:
  复制

  {
    "kkoomen/vim-doge",
  }

• Open nvim and run :call doge#install()

Configuration

Run :help doge to get the full help page.

Choosing a different doc standard

Vim-doge supports multiple doc standard and you can overwrite them per filetype in your vimrc. Is your favorite doc standard not supported? [Suggest a new doc standard][suggest-doc-standard] :tada:

Example:

let g:doge_doc_standard_python = 'numpy'

If you want to change the doc standard specifically for a buffer, then you can do:

" Inside test.py
:let b:doge_doc_standard = 'numpy'

If you want to generate a docblock using a different doc standard just for a specific expression, then you can use the DogeGenerate command:

" Inside test.py, cursor is at a function expression (cursor = `|`):
"   |def foo(p1, p2):
"       pass
:DogeGenerate numpy

Here is the full list of available doc standards per filetype:

:warning: For C and C++, see C Family Doc Standard Examples.