Update global-json.md

docs/core/tools/global-json.md

@@ -1,43 +1,64 @@
 ---
-title: Global.json reference
-description: Global.json reference
+title: global.json reference | .NET Core
+description: global.json reference
 keywords: .NET, .NET Core
 author: aL3891
+ms.author: mairaw
 manager: wpickett
-ms.date: 06/20/2016
+ms.date: 11/02/2016
 ms.topic: article
 ms.prod: .net-core
 ms.technology: .net-core-technologies
 ms.devlang: dotnet
 ms.assetid: e1ac9659-425f-4486-a376-c12ca942ead8
 ---
 
-# Global.json reference
+# global.json reference
 
-* [projects/sources](#projects)
-* [packages](#packages)
+The global.json file is used on .NET Core projects to define the solution metadata. This file is used when the [dotnet-restore](dotnet-restore.md) command is invoked to restore the dependencies of a .NET Core project.
+In this reference topic, you'll see the list of the properties you can define in your global.json file.
 
-<a name="projects"></a>
 ## projects
 Type: String[]
 
-Specifies what folders the build system should search for projects when resolving dependencies.  The build system will only search top level child folders.
-
-<a name="packages"></a>
-## packages
-Type: String[]
-
-The folder to store packages.
-
-
+Specifies which folders the build system should search for projects when resolving dependencies. The build system will only search top-level child folders.
 
+For example:
 
+```json
+{
+    "projects": [ "src", "test" ]
+}
+```
 
+## packages
+Type: String
 
+The location to store packages.
 
+For example:
+```json
+{
+    "packages": "packages-dir"
+}
+```
 
+## sdk
+Type: Object
 
+Specifies information about the SDK.
 
+### version
+Type: String
 
+The version of the SDK to use.
 
+For example:
 
+```json
+{
+    "sdk": {
+        "version": "1.0.0-preview2-003121"
+    }
+}
+```