Merge pull request #293 from chakkaradeep/staging

Updated docs to recent updates

Author: chakkaradeep

docs/spfx/set-up-your-developer-tenant.md

@@ -56,20 +56,18 @@ Choose **OK** to create the site collection.
 
 SharePoint will create the developer site and you will be able to see its progress in the SharePoint admin center. After the site is created, you can browse to your developer site collection.
 
-## Put the SharePoint Workbench in the document library
-You need the SharePoint Workbench on your developer site to test your web parts on SharePoint. SharePoint workbench is a developer design surface that enables you to quickly preview and test web parts without deploying them in SharePoint. This procedure uses the default document library in your site collection. This will be called **Documents** in the left navigation.
+## SharePoint Workbench
+SharePoint Workbench is a developer design surface that enables you to quickly preview and test web parts without deploying them in SharePoint. SharePoint Framework developer toolchain contains a version of the Workbench that works locally and helps you quickly test and validate solutions you are building. It is also hosted in your tenancy to preview and test your local web parts in development. You can access the SharePoint Workbench from any SharePoint site in your tenancy by browsing to the following URL:
 
-* Download the [workbench.aspx](https://raw.githubusercontent.com/SharePoint/sp-dev-docs/master/workbench.aspx) file to your local computer. To do this:
-	- Save opened workbench.aspx to your computer. Typically you'd do this by right clicking the page and chosing *"Save as..."* 
-* Upload the file to the **Documents** library in the developer site collection from your computer. To do this:
-	- Open the **Documents** library on SharePoint.
-	- Drag and drop the workbench.aspx to the **Documents** library. Or you can choose **Upload** from the **Documents** library and locate and upload the workbench.aspx file.
+```
+https://your-sharepoint-site/_layouts/workbench.aspx
+```
 
 ## Troubleshooting
 
 You will get an error If you are using a SharePoint site that was provisioned using a self-service site creation. We recommend using a developer site collection or a SharePoint site that was not created using a self-service site creation.
 
-If you get the following exception when moving to the `workbench.aspx` page: 
+If you get the following exception accessing the SharePoint Workbench: 
 
 ```
 "The requested operation is part of an experimental feature that is not supported in the current environment. The requested operation is part of an experimental feature that is not supported in the current environment." 

docs/spfx/set-up-your-development-environment.md

@@ -30,7 +30,6 @@ sudo npm install -g npm@3
 Install a code editor. You can use any code editor or IDE that supports client-side development to build your web part, such as:
 
 * [Visual Studio Code](https://code.visualstudio.com/)
-* [Sublime](https://www.sublimetext.com/)
 * [Atom](https://atom.io)
 * [Webstorm](https://www.jetbrains.com/webstorm) 
 
@@ -46,13 +45,6 @@ Run the following command:
 npm install -g --production windows-build-tools
 ```
 
-#### If you are using Visual Studio	
-If you want to use Visual Studio as your development environment, install the following required tools and updates:
-
-* [Visual Studio 2015](https://go.microsoft.com/fwlink/?LinkId=691978&clcid=0x409)
-* [Visual Studio Update 3](https://www.visualstudio.com/en-us/news/releasenotes/vs2015-update3-vs) or later
-* [Node.js Tools for Visual Studio](https://aka.ms/getntvs)
-
 ### If you are using Ubuntu
 
 You need to install compiler tools using the following command:

docs/spfx/tools-and-libraries.md

@@ -68,8 +68,7 @@ Form more information about webpack, see the following:
 * [TypeScript, React, and Webpack](https://www.typescriptlang.org/docs/handbook/react-&-webpack.html)
 
 ## Yeoman generators
-[Yeoman](http://yeoman.io/) helps you to kickstart new projects, prescribing best practices and tools to help you stay productive.
-SharePoint Yeoman generator will be available as part of the framework to kickstart new client-side web part projects. Once the project is generator, you can use your choice of IDEs like [Visual Studio](https://www.visualstudio.com/products/visual-studio-community-vs) or HTML/JavaScript code editors like [Visual Studio Code](https://code.visualstudio.com/) or [Sublime Text](https://www.sublimetext.com/) or [Atom](https://atom.io/).  
+[Yeoman](http://yeoman.io/) helps you to kickstart new projects, prescribing best practices and tools to help you stay productive. SharePoint Yeoman generator will be available as part of the framework to kickstart new client-side web part projects. 
 
 For more information about Yeoman, see the following:
 
@@ -81,6 +80,15 @@ The following are some common Yeoman generators that you can try, depending on y
 * [generator-react-webpack](https://github.com/newtriks/generator-react-webpack)
 * [generator-angular](https://www.npmjs.com/package/generator-angular)
 
+## Source code editors
+SharePoint Framework is client-side driven and thus you can use your choice of HTML/JavaScript code editors, such as:
+
+* [Visual Studio Code](https://code.visualstudio.com/)
+* [Atom](https://atom.io)
+* [Webstorm](https://www.jetbrains.com/webstorm)
+
+SharePoint Framework documentation uses Visual Studio code in the docs and examples. Visual Studio Code is a lightweight but powerful source code editor from Microsoft which runs on your desktop and is available for Windows, Mac and Linux. It comes with built-in support for JavaScript, TypeScript and Node.js and has a rich ecosystem of extensions for other languages (such as C++, C#, Python, PHP) and runtimes.
+
 ## SharePoint REST APIs
 
 The SharePoint Framework provides key integrations with SharePoint experiences and targets web development. The SharePoint REST APIs enable you to interact with  SharePoint and other workloads that shape your web part functionality. 

docs/spfx/web-parts/basics/known-issues.md

@@ -59,14 +59,13 @@ When the scaffold is complete, you should see the following message indicating a
 For information about troubleshooting any errors, see [Known issues](../basics/known-issues).
 
 ### Using your favorite Code Editor
-Because the SharePoint client-side solution is HTML/TypeScript based, you can use any code editor or IDE that supports client-side development to build your web part, such as:
+Because the SharePoint client-side solution is HTML/TypeScript based, you can use any code editor that supports client-side development to build your web part, such as:
 
 * [Visual Studio Code](https://code.visualstudio.com/)
-* [Sublime](https://www.sublimetext.com/)
 * [Atom](https://atom.io)
 * [Webstorm](https://www.jetbrains.com/webstorm)
 
->**Note:** This article uses Visual Studio code in the steps and examples. You can use any code editor that you prefer. 
+SharePoint Framework documentation uses Visual Studio code in the steps and examples. Visual Studio Code is a lightweight but powerful source code editor from Microsoft which runs on your desktop and is available for Windows, Mac and Linux. It comes with built-in support for JavaScript, TypeScript and Node.js and has a rich ecosystem of extensions for other languages (such as C++, C#, Python, PHP) and runtimes.. 
 
 ## Preview the web part
 To preview your web part, build and run it on a local web server. The client-side toolchain uses HTTPS endpoint by default. However, since a default certificate is not configured for the local dev environment, your browser will report a certificate error. The SPFx toolchain comes with a developer certificate that you can install for building web parts.
@@ -354,7 +353,7 @@ The **HelloWorldWebPart.manifest.json** file defines the web part metadata such
 
 SharePoint Workbench is also hosted in SharePoint to preview and test your local web parts in development. The key advantage is that now you are running in SharePoint context and that you will be able to interact with SharePoint data.
 
-Go to the following URL: 'https://your-sharepoint-site/Shared%20Documents/workbench.aspx'
+Go to the following URL: 'https://your-sharepoint-site/_layouts/workbench.aspx'
 
 >**Note:** If you do not have the SPFx developer certificate installed, then Workbench will notify you that it is configured not to load scripts from localhost. Execute `gulp trust-dev-cert` command in your project directory console to install the developer certificate.