ready to launch

zhengsusan · Jun 19, 2017 · a9eecea · a9eecea
1 parent 4ad2889
commit a9eecea
Show file tree

Hide file tree

Showing 4 changed files with 160 additions and 83 deletions.
diff --git a/breadcrumb/toc.yml b/breadcrumb/toc.yml
@@ -2,34 +2,53 @@
   tocHref: /azure/
   topicHref: /azure/index
   items:
-  - name: Azure for .NET developers
-    tocHref: /dotnet/
-    topicHref: /dotnet/azure/index
-    items:
-    - name: Tools
-      tocHref: /dotnet/azure/dotnet-tools
-      topicHref: /dotnet/azure/dotnet-tools
-    - name: Libraries
-      tocHref: /dotnet/azure/dotnet-sdk-azure-install
-      topicHref: /dotnet/azure/dotnet-sdk-azure-install
+    - name: Azure for .NET developers
+      tocHref: /dotnet/
+      topicHref: /dotnet/azure/index
       items:
-      - name: Get Started
-        tocHref: /dotnet/azure/dotnet-sdk-azure-get-started
-        topicHref: /dotnet/azure/dotnet-sdk-azure-get-started
-      - name: Key concepts
-        tocHref: /dotnet/azure/dotnet-sdk-azure-concepts
-        topicHref: /dotnet/azure/dotnet-sdk-azure-concepts
+      - name: Overview
+        tocHref: /dotnet/azure/dotnet-tools
+        topicHref: /dotnet/azure/dotnet-tools    
+      - name: Tools
+        tocHref: /dotnet/azure/dotnet-tools
+        topicHref: /dotnet/azure/dotnet-tools
+      - name: Libraries
+        tocHref: /dotnet/azure/dotnet-sdk-azure-install
+        topicHref: /dotnet/azure/dotnet-sdk-azure-install
       - name: Authentication
         tocHref: /dotnet/azure/dotnet-sdk-azure-authenticate
         topicHref: /dotnet/azure/dotnet-sdk-azure-authenticate
+      - name: Quickstarts  
+        items:
+          - name: Get Started
+            tocHref: /dotnet/azure/dotnet-sdk-azure-get-started
+            topicHref: /dotnet/azure/dotnet-sdk-azure-get-started
+          - name: Web Apps
+            tocHref: /azure/app-service-web/app-service-web-get-started-dotnet
+            topicHref: /azure/app-service-web/app-service-web-get-started-dotnet
+          - name: SQL Database
+            tocHref: /azure/sql-database/sql-database-connect-query-dotnet
+            topicHref: /azure/sql-database/sql-database-connect-query-dotnet
+          - name: CosmosDB
+            tocHref: /azure/cosmos-db/documentdb-dotnet-application
+            topicHref: /azure/cosmos-db/documentdb-dotnet-application
+      - name: Tutorials
+        items:
+          - name: Azure Storage
+            tocHref: /azure/storage/storage-dotnet-how-to-use-blob-storage
+            topicHref: /azure/storage/storage-dotnet-how-to-use-blob-storage
+          - name: Redis Cache
+            tocHref: /azure/redis-cache/cache-web-app-howto
+            topicHref: /azure/redis-cache/cache-web-app-howto
+      - name: How-To
         items:
-        - name: Create a service principal
-          tocHref: /powershell/azure/create-azure-service-principal-azureps
-          topicHref: /powershell/azure/create-azure-service-principal-azureps
-      - name: Release notes
-        tocHref: /dotnet/azure/dotnet-sdk-azure-release-notes
-        topicHref: /dotnet/azure/dotnet-sdk-azure-release-notes
-      - name: Sample code
+          - name: Deploy with Visual Studio
+            tocHref: /dotnet/azure/dotnet-quickstart-vs
+            topicHref: /dotnet/azure/dotnet-quickstart-vs
+          - name: Deploy with command line tools
+            tocHref: /dotnet/azure/dotnet-quickstart-xplat
+            topicHref: /dotnet/azure/dotnet-quickstart-xplat
+      - name: Samples
         items:
         - name: Instructions
           tocHref: /dotnet/azure/dotnet-sdk-azure-sample-readme
@@ -43,17 +62,7 @@
         - name: SQL Database
           tocHref: /dotnet/azure/dotnet-sdk-azure-sql-database-samples
           topicHref: /dotnet/azure/dotnet-sdk-azure-sql-database-samples
-    - name: Tutorials
-      items:
-        - name: SQL Database
-          tocHref: /azure/sql-database/sql-database-connect-query-dotnet
-          topicHref: /azure/sql-database/sql-database-connect-query-dotnet
-        - name: CosmosDB
-          tocHref: /azure/cosmos-db/documentdb-dotnet-application
-          topicHref: /azure/cosmos-db/documentdb-dotnet-application
-        - name: Azure Storage
-          tocHref: /azure/storage/storage-dotnet-how-to-use-blob-storage
-          topicHref: /azure/storage/storage-dotnet-how-to-use-blob-storage
-        - name: Redis Cache
-          tocHref: /azure/redis-cache/cache-web-app-howto
-          topicHref: /azure/redis-cache/cache-web-app-howto
+      - name: Key concepts
+        tocHref: /dotnet/azure/dotnet-sdk-azure-concepts
+        topicHref: /dotnet/azure/dotnet-sdk-azure-concepts
+
diff --git a/docs-ref-conceptual/TOC.yml b/docs-ref-conceptual/TOC.yml
@@ -1,42 +1,19 @@
 - name: Azure for .NET developers
   href: index.md
   items:
+    - name: Overview
+      href: dotnet-sdk-azure-overview.md
     - name: Tools
       href: dotnet-tools.md
     - name: Libraries
       href: dotnet-sdk-azure-install.md
-      items: 
-      - name: Get started
-        href: dotnet-sdk-azure-get-started.md
-      - name: Key concepts
-        href: dotnet-sdk-azure-concepts.md
-      - name: Authentication
-        href: dotnet-sdk-azure-authenticate.md
-        items:
-        - name: Create a service principal
-          href: https://docs.microsoft.com/powershell/azure/create-azure-service-principal-azureps?&view=azurermps-4.1.0
-          maintainContext: true
-      - name: Release notes
-        href: dotnet-sdk-azure-release-notes.md
-      - name: Sample code
-        items: 
-        - name: Instructions
-          href: dotnet-sdk-azure-sample-readme.md
-        - name: Virtual machines
-          href: dotnet-sdk-azure-virtual-machine-samples.md
-        - name: Web Apps
-          href: dotnet-sdk-azure-web-apps-samples.md
-        - name: SQL Database
-          href: dotnet-sdk-azure-sql-database-samples.md
+    - name: Authentication
+      href: dotnet-sdk-azure-authenticate.md
     - name: Quickstarts
       items:
-        - name: Visual Studio  
-          href: dotnet-quickstart-vs.md
-        - name: Command line
-          href: dotnet-quickstart-xplat.md
-    - name: Tutorials
-      items:
-        - name: App Service
+        - name: Azure libraries
+          href: dotnet-sdk-azure-get-started.md
+        - name: Web Apps
           href: https://docs.microsoft.com/azure/app-service-web/app-service-web-get-started-dotnet
           maintainContext: true
         - name: SQL Database
@@ -45,11 +22,31 @@
         - name: CosmosDB
           href: https://docs.microsoft.com/azure/cosmos-db/documentdb-dotnet-application
           maintainContext: true
-        - name: Azure Storage
-          href: https://docs.microsoft.com/azure/storage/storage-dotnet-how-to-use-blob-storage
-          maintainContext: true
-        - name: Redis Cache
+    - name: Tutorials
+      items:
+        - name: Use Redis Cache with ASP.NET
           href: https://docs.microsoft.com/azure/redis-cache/cache-web-app-howto
           maintainContext: true
+        - name: Use Azure Blob Storage
+          href: https://docs.microsoft.com/azure/storage/storage-dotnet-how-to-use-blob-storage
+          maintainContext: true
+    - name: How-To
+      items:
+        - name: Deploy with Visual Studio  
+          href: dotnet-quickstart-vs.md
+        - name: Deploy with command line tools
+          href: dotnet-quickstart-xplat.md
     - name: Samples
-      href: https://azure.microsoft.com/resources/samples/?platform=dotnet
+      items:
+        - name: Instructions
+          href: dotnet-sdk-azure-sample-readme.md
+        - name: Virtual machines
+          href: dotnet-sdk-azure-virtual-machine-samples.md
+        - name: Web Apps
+          href: dotnet-sdk-azure-web-apps-samples.md
+        - name: SQL Database
+          href: dotnet-sdk-azure-sql-database-samples.md
+        - name: All .NET samples
+          href: https://azure.microsoft.com/resources/samples/?platform=dotnet
+    - name: Concepts
+      href: dotnet-sdk-azure-concepts.md
diff --git a/docs-ref-conceptual/dotnet-sdk-azure-overview.md b/docs-ref-conceptual/dotnet-sdk-azure-overview.md
@@ -0,0 +1,56 @@
+---
+title: Azure libraries for .NET
+description: Overview of the Azure SDK for .NET
+keywords: Azure, .NET, SDK, API, NuGet
+author: camsoper
+ms.author: casoper
+manager: douge
+ms.date: 06/20/2017
+ms.topic: article
+ms.prod: azure
+ms.technology: azure
+ms.devlang: dotnet
+ms.service: multiple
+---
+
+# Azure libraries for .NET
+
+The Azure libraries for .NET let you use Azure services and manage Azure resources from your application code. The libraries are available as [NuGet packages](dotnet-sdk-azure-install.md) for use in your .NET projects. 
+
+## Manage Azure resources
+
+The Azure libraries for .NET let you create and manage Azure resources from your .NET applications.
+
+Many of the packages for managing Azure resources have a [fluent](dotnet-sdk-azure-concepts.md) interface to configure resources exactly to your specifications. For example, to create a Windows VM you would write the following code:
+
+```csharp
+var windowsVM = azure.VirtualMachines.Define(windowsVmName)
+    .WithRegion(Region.USEast)
+    .WithNewResourceGroup(rgName)
+    .WithNewPrimaryNetwork("10.0.0.0/28")
+    .WithPrimaryPrivateIPAddressDynamic()
+    .WithNewPrimaryPublicIPAddress(publicIpDnsLabel)
+    .WithPopularWindowsImage(KnownWindowsVirtualMachineImage.WindowsServer2012R2Datacenter)
+    .WithAdminUsername(username)
+    .WithAdminPassword(password)
+    .WithSize(VirtualMachineSizeTypes.StandardD3V2)
+    .Create();
+ ```
+
+Review the [install instructions](dotnet-sdk-azure-install.md) to start using the libraries immediately with your projects. Then read the [get started article](dotnet-sdk-azure-get-started.md) to set up authentication and run sample code against your own Azure subscription.  The [concepts article](dotnet-sdk-azure-concepts.md) goes into the conventions the SDK uses and how to leverage them to simplify your application code. New features, breaking changes, and migration instructions are available in the [release notes](dotnet-sdk-azure-release-notes.md).
+
+## Consume Azure services
+
+In addition to using .NET APIs to create and programmatically manage resources within Azure, you can also then use .NET APIs to connect your applications to these resources and use them at runtime.  For example, you might connect to a SQL Database or store data within Azure Storage.  You can identify which NuGet package to use for a particular Azure service by browsing our [full list of NuGet packages](dotnet-sdk-azure-install.md#data).  
+
+## Samples
+
+The following samples cover common automation tasks with the Azure libraries for .NET:
+
+- [Virtual machines](dotnet-sdk-azure-virtual-machine-samples.md)
+- [Web apps](dotnet-sdk-azure-web-apps-samples.md)
+- [SQL Database](dotnet-sdk-azure-sql-database-samples.md)
+
+A unified [reference](/dotnet/api/overview/azure/?view=azure-dotnet) is available for all packages in both the service and management libraries. New features, breaking changes, and migration instructions are available in the [release notes](dotnet-sdk-azure-release-notes.md).
+
+[!include[Contribute and community](includes/contribute.md)]
diff --git a/docs-ref-conceptual/index.md b/docs-ref-conceptual/index.md
@@ -45,8 +45,30 @@ ms.service: multiple
             </div>
         </div>
     </li>
+    <li>
+        <div class="cardSize">
+            <div class="cardPadding">
+                <div class="card">
+                    <div class="cardText">
+                        <a href="https://www.visualstudio.com/docs/build/get-started/aspnet-4-ci-cd-azure-automatic">
+                            <h2>VSTS CI/CD</h2>
+                            <span>Use VSTS to deploy apps to Azure.</span>
+                        </a>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </li>
 </ul>
 
+## Five-minute quickstarts
+
+Create and deploy an app using your favorite tools in five minutes.
+
+* [App Service](/azure/app-service-web/app-service-web-get-started-dotnet?toc=%2fdotnet%2fazure%2ftoc.json&bc=%2fdotnet%2fazure_breadcrumb%2ftoc.json)
+* [SQL Database](/azure/sql-database/sql-database-connect-query-dotnet?toc=%2fdotnet%2fazure%2ftoc.json&bc=%2fdotnet%2fazure_breadcrumb%2ftoc.json)
+* [CosmosDB](/azure/cosmos-db/documentdb-dotnet-application?toc=%2fdotnet%2fazure%2ftoc.json&bc=%2fdotnet%2fazure_breadcrumb%2ftoc.json)
+
 ## Manage Azure resources
 
 Import the [Azure management libraries for .NET](dotnet-sdk-azure-install.md) to manage your Azure resources with an easy-to-use [fluent API](dotnet-sdk-azure-concepts.md). 
@@ -67,19 +89,12 @@ var windowsVM = azure.VirtualMachines.Define(windowsVmName)
 
 [Get started with the Azure management libraries for .NET](dotnet-sdk-azure-get-started.md)
 
-## Five-minute quickstarts
 
-Create and deploy an app using your favorite tools in five minutes.
-
-* [Visual Studio](dotnet-quickstart-vs.md)
-* [Command line](dotnet-quickstart-xplat.md)
-
-## Tutorials and samples
+## Tutorials
 
-Complete walkthroughs for app creation and deployment.
+Learn how to use Azure services and tools in your .NET apps.
 
-* [App Service](/azure/app-service-web/app-service-web-get-started-dotnet?toc=%2fdotnet%2fazure%2ftoc.json&bc=%2fdotnet%2fazure_breadcrumb%2ftoc.json)
-* [SQL Database](/azure/sql-database/sql-database-connect-query-dotnet?toc=%2fdotnet%2fazure%2ftoc.json&bc=%2fdotnet%2fazure_breadcrumb%2ftoc.json)
-* [CosmosDB](/azure/cosmos-db/documentdb-dotnet-application?toc=%2fdotnet%2fazure%2ftoc.json&bc=%2fdotnet%2fazure_breadcrumb%2ftoc.json)
+* [Deploy from Visual Studio](dotnet-quickstart-vs.md)
+* [Deploy from the command line](dotnet-quickstart-xplat.md)
 * [Azure Storage](/azure/storage/storage-dotnet-how-to-use-blob-storage?toc=%2fdotnet%2fazure%2ftoc.json&bc=%2fdotnet%2fazure_breadcrumb%2ftoc.json)
 * [Redis Cache](/azure/redis-cache/cache-web-app-howto?toc=%2fdotnet%2fazure%2ftoc.json&bc=%2fdotnet%2fazure_breadcrumb%2ftoc.json)