doc: Misc. improvements to nvim-related docs

- Improved wording in a few places for clarity
- Various capitalization/grammar fixes
- Change references to Neovim as 'editor' to 'Nvim'
- Be consistent regarding utilization of vim's documentation features,
  e.g. unnamedclip -> |unnamedclip|
- Reflowed all changed paragraphs accordingly

- Add spaces before parentheses
- Remove trailing whitespace
- Standardize single spaces after periods. Vim's docs use two for the
  most part, but Nvim's use one mainly, so just follow Nvim's conventions
Merge pull request #1624 from Pyrohh/doc-fixes

doc: Misc. improvements to nvim-related docs