Merge pull request #36 from bradygaster/telemetry

Telemetry

Author: bradygaster

CONTRIBUTING.md

@@ -10,13 +10,15 @@ We've added some guideliness to help you in your quest. Please read and feel fre
 4. Let us know if you have any questions or you're unsure of something
 5. Please fork the project and create a new branch to commit your work
 6. DO NOT push to master. If you don't know what this means, refresh your memory [here](https://git-scm.com/book/en/v2/Git-Branching-Branches-in-a-Nutshell) 
+7. We use [App Insights](https://azure.microsoft.com/en-us/services/application-insights/) to track telemetry and ask that you make use of the `telemetry` module to capture telemetry on features you add. 
 
 ## Setting up the project locally
 1. Ensure you have Node.js installed. Get it [here](https://nodejs.org/en/)
 2. Ensure you have Visual Studio Code installed. Get it [here](https://code.visualstudio.com/Download)
 3. Ensure you have Git installed. Get it [here](https://git-scm.com/download)
 4. Open the command line of your choice and navigate to the root of the project folder
 5. Run `npm install` to install the npm packages necessary to run the project
+6. Edit the `constants.js` file and provide your own Instrumentation Key to use during development so you can see how your telemetry is coming in. Prior to being deployed to the marketplace, I'll update this to be the production key. 
 
 ## Testing your code changes
 At the moment we don't have automated tests. Trust us, we're working on it. However, you're more than welcome to contribute if you've got time or feel you're up to the task. To test your code changes, launch the debugger from within VS Code. This will launch a separate instance of VS Code with the extension already installed. Step through the code as you would do norrmally.

README.md

@@ -2,15 +2,33 @@
 
 This extension for [Visual Studio Code](http://code.visualstudio.com) gives Azure developers some convenient commands for creating or accessing resources directly in the editor. 
 
-## New in v1.1.0
+## New in v1.2.0
+Here's a brief summary of the new features included in the 1.2.0 release.
 
-- **Azure Key Vault creation.**
+### Export Template
 
-    You can now use the Azure Tools for Visual Studio Code to create new Key Vault instances. Selecting the **Create Key Vault** command. Then you can create a new or select an existing resource group into which your new Key Vault will be created. 
+In 1.2.0 we've added support for exporting existing resource groups to ARM templates saved in your workspace. First, you invoke the `Export` command using the palette. 
 
-    ![Create Key Vault](media/docs/Screenshot_150.png)
+![Export command](media/docs/Screenshot_162.png)
+
+Then you select an existing resource group. 
+
+![Select a resource group](media/docs/Screenshot_163.png)
+
+A few seconds later, the resource group's contents are downloaded as an ARM template and stored into your current workspace's `arm-templates` folder. 
+
+![Export command](media/docs/Screenshot_164.png)
+
+> **Note:** As of the 1.2.0 release time frame there are a few kinks in the particular Azure API call we're using; certain details of your resources might not be persisted exactly right. You can use the great features contained in the [Azure Resource Manager Tools extension](https://marketplace.visualstudio.com/items?itemName=msazurermtools.azurerm-vscode-tools) (which bundled with this extension) to make tweaks. The API owners are working on making great improvements to this functionality so it'll improve in future releases of the back-end API.
+
+### Azure Batch account creation
+
+From within Visual Studio Code you can use the `Create Azure Batch` command from the palette, shown below, to create new Azure Batch accounts. Future releases may add support for scripting against your Batch account, creating Jobs, and so forth. Feel free to send the team requests for additional Batch features via our [GitHub Issues page](https://github.com/bradygaster/azure-tools-vscode/issues).
+
+![Create Key Vault](media/docs/Screenshot_161.png)
 
 ## Features
+- Azure Key Vault Creation
 - Search the [Azure QuickStart Templates](https://github.com/Azure/azure-quickstart-templates) GitHub repository
 - Download Azure Resource Manager (ARM) template and parameter files to workspace
 - Uses the [Azure Resource Manager Tools](https://marketplace.visualstudio.com/items?itemName=msazurermtools.azurerm-vscode-tools) extension to simplify the template-editing experience
@@ -30,8 +48,14 @@ Each of these commands is visible directly from commands visible in the command
 
 ![Azure Tools Commands](media/docs/commands.png)
 
-## New Azure Resource Manager (ARM) Features
-**New in 1.0.0** - Now you can use keyword searches to find one of the numerous existing templates in the Azure QuickStart Templates repository, then download the templates you find and deploy them **all within Visual Studio Code**. 
+## Azure Key Vault creation
+
+You can now use the Azure Tools for Visual Studio Code to create new Key Vault instances. Selecting the **Create Key Vault** command. Then you can create a new or select an existing resource group into which your new Key Vault will be created. 
+
+![Create Key Vault](media/docs/Screenshot_150.png)
+
+## Azure Resource Manager (ARM) Features
+You can use keyword searches to find one of the numerous existing templates in the Azure QuickStart Templates repository, then download the templates you find and deploy them **all within Visual Studio Code**. 
 
 ### Search and Download from the Azure Template QuickStart Repository
 Templates in the QuickStart repository are easily searchable from within Visual Studio Code. 

media/docs/Screenshot_161.png

@@ -135,22 +135,23 @@
     "msazurermtools.azurerm-vscode-tools"
   ],
   "dependencies": {
+    "adal-node": "^0.1.17",
+    "applicationinsights": "^0.18.0",
+    "azure-arm-batch": "0.3.0",
     "azure-arm-keyvault": "0.11.4",
     "azure-arm-resource": "1.5.1-preview",
     "azure-arm-storage": "^0.13.4-preview",
     "azure-arm-website": "0.11.4",
     "azure-gallery": "^2.0.0-pre.20",
-    "azure-arm-batch": "0.3.0",
-    "documentdb": "1.10.1",
+    "azure-keyvault": "^1.0.0",
     "copy-paste": "^1.3.0",
+    "documentdb": "1.10.1",
     "download-file": "^0.1.5",
     "fs-path": "0.0.23",
     "get-urls": "^5.0.1",
+    "moment": "^2.17.1",
     "ms-rest-azure": "1.15.2",
     "octonode": "^0.7.7",
-    "open": "0.0.5",
-    "moment": "^2.17.1",
-    "azure-keyvault": "^1.0.0",
-    "adal-node": "^0.1.17"
+    "open": "0.0.5"
   }
 }