(maint) README Improvements
(maint) README Improvements

This commit overhauls the readme by arranging everything into proper
sections and adding a table of contents. It adds new content for several
sections and fixes wording in others.

glennsarti/puppet-vscode,jpogran/puppet-vscode,jpogran/puppet-vscode