README: various improvements

- Edit main title to be more informative
- Unwrap some lines, since wrapping was inconsistent
- Add link to page explaining VSCode extensions
- Add alt text to the screenshots
- Add missing word ("engine")
- Format commands as code
- Harmonize verb tense in step-by-step instructions
- Format keyboard shortcuts with the <kbd> element
- A few additional minor tweaks

Author: waldyrious

README.md

@@ -1,43 +1,46 @@
-# vscode-nushell-lang README
+# vscode-nushell-lang VSCode extension
 
-This extension provides editing and syntax highlighting support
-for [Nushell](http://nushell.sh), a data driven document language.
+This [extension for VSCode](https://code.visualstudio.com/docs/introvideos/extend) provides editing and syntax highlighting support for [Nushell](http://nushell.sh), a data-driven document language.
 
 ## Features
 
-* Syntax highlighting grammar
+* Syntax highlighting grammar for Nushell scripts (`.nu` files)
 * Nushell theme that tries to match Nushell's coloring
 
 ## Screenshot (v0.0.4)
+
 With Nushell Color Theme
-![](004-nushell.png)
+![Nushell script with Nushell color theme](004-nushell.png)
 With VSDark+ Color Theme
-![](004-vsdark.png)
+![Nushell script with VSDark+ color theme](004-vsdark.png)
 
 ## Known Issues
 
-See [our Github repository](https://github.com/nushell/vscode-nushell-lang/issues)
-for active issues.
+See [our Github repository](https://github.com/nushell/vscode-nushell-lang/issues) for active issues.
 
 ## Regex Engine
 
-VSCode uses a regular expressions that is based on Ruby for syntax highlighting. [This is a good site](https://rubular.com/) to test and try out these regular expressions.
+VSCode uses a regular expressions engine that is based on Ruby for syntax highlighting.
+[This is a good site](https://rubular.com/) to test and try out these regular expressions.
 
 ## Build Process
 
-We pretty much followed [these instructions](https://code.visualstudio.com/api/get-started/your-first-extension) for building this extension. And [this link](https://code.visualstudio.com/api/working-with-extensions/publishing-extension) for packaging the extension.
+We pretty much followed [these instructions](https://code.visualstudio.com/api/get-started/your-first-extension) for building this extension.
+And [this link](https://code.visualstudio.com/api/working-with-extensions/publishing-extension) for packaging the extension.
+
+To summarize, the steps were:
 
-To summarize:
-1. npm install -g yo generator-code
-2. yo code
-3. chose `New Language Support` and filled out the rest of the questions
-4. npm install -g vsce
-5. update the readme and package.json
-6. vsce package
-7. code --install-extension vscode-nushell-lang-0.0.2.vsix or alternatively you can do ctrl/cmd-shift-p Extensions:Install From VSIX...
+1. `npm install -g yo generator-code`
+2. `yo code`
+3. choose "New Language Support" and fill out the rest of the questions
+4. `npm install -g vsce`
+5. update the `README.md` and `package.json`
+6. `vsce package`
+7. `code --install-extension vscode-nushell-lang-0.0.2.vsix`<br/>
+   (Alternatively, you can do <kbd>Ctrl</kbd>/<kbd>Cmd</kbd>-<kbd>Shift</kbd>-<kbd>P</kbd> and type "Extensions:Install From VSIX...")
 
-If you have all these tools already installed you should be able to clone this repo and just do a `vsce package` to get a vsix file that you can install in vscode.
+If you have all these tools already installed, you should be able to clone this repo and just run `vsce package` to get a `.vsix` file that you can install in vscode.
 
 ## Help
 
-We are happily accepting pull requests to make this better. :)
+We are happily accepting pull requests to make this better. :)