message: Add notes about commentary to README.md
diff: @@ -11,6 +11,7 @@ VSCodeVim is a [Visual Studio Code](https://code.visualstudio.com/) extension th
  * Multi-cursor support. Allows multiple simultaneous cursors to receive Vim commands (e.g. allows `/` search, each cursor has independent clipboards, etc.).
  * The [EasyMotion plugin](#how-to-use-easymotion)!
  * The [Surround.vim plugin](#how-to-use-surround)!
  +* The [Commentary plugin](#how-to-use-commentary).
  * And much more! Refer to the [roadmap](ROADMAP.md) or everything we support.
  Please [report missing features/bugs on GitHub](https://github.com/VSCodeVim/Vim/issues), which will help us get to them faster.
  @@ -329,6 +330,31 @@ Some examples:
  * `"test"` with cursor inside quotes type cs"t and enter 123> to end up with `<123>test</123>`
  * `test` with cursor on word test type ysaw) to end up with `(test)`
  +#### How to use commentary
  +
  +Commentary in VSCodeVim works similarly to tpope's [vim-commentary] (https://github.com/tpope/vim-commentary) but uses the VSCode native "Toggle Line Comment" and "Toggle Block Comment" features.
  +
  +Because `gc` is already used in VSCodeVim the commentary operators are bound to `gb` for line comments and `gB` for block comments.
  +
  +Usage examples:
  +* `gb` - toggles line comment. For example `gbb` to toggle line comment for current line and `gb2j` to toggle line comments for the current line and the next line.
  +* `gB` - toggles block comment. For example `gBi)` to comment out everything within parenthesis.
  +
  +If you are use to using vim-commentary you are probably use to using `gc` instead of `gb`. This can be achieved by adding the following remapping to your VSCode settings:
  +
  +```
  +"vim.otherModesKeyBindings": [
  + {
  + "before": ["g", "c"],
  + "after": ["g", "b"]
  + },
  + {
  + "before": ["g", "C"],
  + "after": ["g", "B"]
  + }
  +],
  +```
  +
  ## Contributing
  This project is maintained by a group of awesome [people](https://github.com/VSCodeVim/Vim/graphs/contributors) and contributions are extremely welcome :heart:. For a quick tutorial on how you can help, see our [contributing guide](/.github/CONTRIBUTING.md).
  