Add description for vscode-yaml

docs/languages/vscode-yaml.md

@@ -4,4 +4,16 @@ sidebar_position: 2
 
 # VS Code YAML
 
-[Visit the GitHub](https://github.com/redhat-developer/vscode-yaml)
+[![Link to GitHub](https://img.shields.io/badge/GitHub-redhat%E2%80%93developer%2Fvscode%E2%80%93yaml-GitHub?style=for-the-badge&logo=github&logoColor=white&color=black)](https://github.com/redhat-developer/vscode-yaml)
+[![Visual Studio Marketplace](https://img.shields.io/visual-studio-marketplace/v/redhat.vscode-yaml?color=informational&logo=visualstudiocode&style=for-the-badge&label=VS%20Marketplace)](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml)
+[![Installs](https://img.shields.io/visual-studio-marketplace/i/redhat.vscode-yaml?logo=visualstudiocode&color=informational&style=for-the-badge)](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml)
+
+VS Code YAML provides comprehensive YAML Language support to Visual Studio Code, via the yaml-language-server.
+It has built-in Kubernetes syntax support,
+and can validate documents against schemas from [JSON Schema Store](https://www.schemastore.org/json/).
+
+![Screencapture of VS Code demonstrating the various features that VS Code YAML provides](/img/vscode-yaml.gif)
+
+For a complete list of features, please see the GitHub README.
+
+[Visit the GitHub](https://github.com/redhat-developer/vscode-yaml)