Merge pull request #1396 from MicrosoftDocs/master

Reorganized the CDS overview and Get Started topics

Author: KumarVivek

powerapps-docs/developer/common-data-service/get-started-CDS-developers.md

@@ -1,20 +1,13 @@
 ---
 title: "Developers: Get started with Common Data Service | Microsoft Docs"
 description: Learn how developers can add value using Common Data Service in PowerApps.
-services: ''
 suite: powerapps
-documentationcenter: na
 author: JimDaly
-manager: kvivek
-editor: ''
-tags: ''
+manager: annbe
 ms.service: powerapps
-ms.devlang: na
-ms.topic: article
-ms.tgt_pltfrm: na
-ms.workload: na
-ms.date: 10/31/2018
+ms.date: 03/27/2019
 ms.author: jdaly
+ms.reviewer: kvivek
 search.audienceType: 
   - developer
 search.app: 
@@ -24,55 +17,42 @@ search.app:
 
 # Developers: Get started with Common Data Service
 
-There are many aspects to how developers can contribute to creating apps that use Common Data Service. While it is possible to build an application with code using Common Data Service as your data source, most projects will use either model-driven driven apps or canvas apps to generate the experience that people will use. 
+Where to start depends on what problem you are trying to solve. This guide includes information about a wide range of capabilities and it is unlikely you will ever use all of them. The following sections include several of the key areas to begin.
 
-## Working with model-driven apps
+## Work with data using Web services
 
-Model-driven apps are built on Common Data Service. A model-driven app can only connect to a Common Data Service environment and all the data that defines a model-driven app is stored within Common Data Service.
+There are two different web services that you can use to work with data: **Web API** and **Organization service**. 
 
-Model-driven apps share the method of distributing customizations and extensions used by Common Data Service: Solutions. You can learn more about solutions in [Introduction to solutions](introduction-solutions.md)
+Which one you should use depends on the type of project you are working on. More information: [Work with data using code](work-with-data-cds.md)
 
-Model driven apps also have a number of points for developers to write code to extend. For information on what developers can do with model-driven apps, see [Model-driven apps Developer Overview](../model-driven-apps/overview.md)
+## Applying business logic
 
-## Understand when to write code
-
-Because Common Data Service includes many capabilities for people to configure custom business logic without writing code, the most common scenarios for developers to contribute involve filling spaces in-between where existing features may not provide functionality you need to meet a requirement. Fortunately, Common Data Service provides many points for developers to extend the common functionality using code.
-
-For a developer who will contribute to projects it is important that they understand what can be done without writing code. You should familiarize yourself with these capabilities. More information: [What is Common Data Service?](../../maker/common-data-service/data-platform-intro.md)
-
-## Where to begin?
-
-Where to begin depends on what problem you are trying to solve. This guide includes content about a wide range of capabilities and it is unlikely you will ever use all of them. The following includes several of the key areas to begin.
-
-> [Work with data using web services](#work-with-data-using-web-services)<br/>
-> [Applying business logic](#applying-business-logic)<br/>
-> [Common Data Service entities](#cds-for-apps-entities)<br/>
-> [Work with metadata](#work-with-metadata)<br/>
-> [Use solutions to package and distribute extensions](#use-solutions-to-package-and-distribute-extensions)<br/>
-> [Create client applications and authentication](#create-client-applications-and-authentication)<br/>
-> [Content for on-premises deployments](#content-for-on-premises-deployments)<br/>
-
-### Work with data using Web services
+The most common extensions created using code involve automating the processes used by businesses. You can find a summary of options available for you in [Apply business logic with code](apply-business-logic-with-code.md). Each of these approaches are typically invoked based on events that occur on the server, so understanding of the [Event Framework](event-framework.md) will be valuable.
 
-There are two different web services that you can use to work with data. Which one you should use depends on the type of project you are working on. More information: [Work with data using code](work-with-data-cds.md)
+## Integrate with external data
 
-### Applying business logic
+Data management capabilities in Common Data Service not only lets you work with data within Common Data Service, but also effectively interact with external data critical to your business. More information: 
 
-The most common extensions created using code involve automating the processes used by businesses. You can find a summary of options available for you in [Apply business logic with code](apply-business-logic-with-code.md). Each of these approaches are typically invoked based on events that occur on the server, so understanding of the [Event Framework](event-framework.md) will be valuable.
+- [Import data](/powerapps/developer/common-data-service/import-data)
+- [Synchronize data](/powerapps/developer/common-data-service/data-synchronization)
+- [Virtual entities](/powerapps/developer/common-data-service/virtual-entities/get-started-ve)
+- [Azure Integration](/powerapps/developer/common-data-service/azure-integration)
+- [Webhooks](/powerapps/developer/common-data-service/use-webhooks
+)
 
-### Common Data Service entities
+## Common Data Service entities
 
 Entities store the business data you will work with. An understanding what they are and how to work with them is essential.
 More information:
 
 - [Common Data Service entities](entities.md)
 - [About the Entity Reference](reference/about-entity-reference.md)
 
-### Work with metadata
+## Work with metadata
 
 Developing a good working understanding of the metadata in the system can help you understand how Common Data Service platform works. Generally you will use designers to add, update, or delete entity schema that defines metadata, but both the Web API and the Organization service web services provide capabilities to perform CRUD operations on the entity schema. More information: [Work with metadata using code](metadata-services.md) 
 
-### Use solutions to package and distribute extensions
+## Use solutions to package and distribute extensions
 
 If you are going to distribute the extensions you create or any customizations that they depend on, you will need to understand solutions. Solutions created by an individual are relatively simple to work with and don't require the skills of a developer. But for a team of developers to work productively with solutions and use effective application lifecycle management principles requires a more sophisticated approach. More information:
 
@@ -81,16 +61,10 @@ If you are going to distribute the extensions you create or any customizations t
  - [Package Deployer tool](./package-deployer/create-packages-package-deployer.md)
  - [Publish your app on AppSource](publish-app-appsource.md)
 
-### Create client applications and authentication
+## Create client applications and authentication
 
-When you create extensions that apply business logic on the server you will not need to include code to authenticate. The only times you will need to authenticate are when you are creating a client application. A simple console client application is a good way to familiarize yourself with the Common Data Service APIs. Enabling a means to connect to the data is an important first step. Most of the code samples provided include a means to authenticate. The Xrm.Tooling connector provides capabilities to make authentication simpler. More information:
+When you create extensions that apply business logic on the server you will not need to include code to authenticate. The only times you will need to authenticate are when you are [creating a client application](/powerapps/developer/common-data-service/connect-cds). A simple console client application is a good way to familiarize yourself with the Common Data Service APIs. Enabling a means to connect to the data is an important first step. Most of the code samples provided include a means to authenticate. The Xrm.Tooling connector provides capabilities to make authentication simpler. More information:
 
 - [Authentication](authentication.md)
-- [Create Client applications](connect-cds.md)
-- [Quick Start: Create a console app using the organization service](org-service/quick-start-org-service-console-app.md)
-- [Quick Start: Web API sample (C#)](webapi/quick-start-console-app-csharp.md)
-- [Sample: Quick start for XRM Tooling API](xrm-tooling/sample-quick-start-xrm-tooling-api.md)
-
-## Content for on-premises deployments
-
-Common Data Service is not available for on-premise deployments at this time. Content in this guide does not include information about options that are only available for on-premises or internet facing deployments(IFD). For information related to these options, see the [Software Development Kit for Microsoft Dynamics 365 (online) and Dynamics 365 (on-premises)](https://msdn.microsoft.com/library/hh547453.aspx).
+- [Build web applications using Server-to-Server (S2S) authentication](/powerapps/developer/common-data-service/build-web-applications-server-server-s2s-authentication)
+- [Build Windows client applications using XRM tools](/powerapps/developer/common-data-service/xrm-tooling/build-windows-client-applications-xrm-tools)

powerapps-docs/developer/common-data-service/overview.md

@@ -1,20 +1,13 @@
 ---
 title: Common Data Service Developer Guide | Microsoft Docs
 description: Learn how developers can add value using Common Data Service.
-services: ''
-suite: powerapps
-documentationcenter: na
 author: JimDaly
-manager: kvivek
-editor: ''
-tags: ''
+manager: annbe
 ms.service: powerapps
-ms.devlang: na
 ms.topic: article
-ms.tgt_pltfrm: na
-ms.workload: na
-ms.date: 10/31/2018
+ms.date: 03/27/2019
 ms.author: jdaly
+ms.reviewer: kvivek
 search.audienceType: 
   - developer
 search.app: 
@@ -24,14 +17,35 @@ search.app:
 
 # Common Data Service Developer Guide
 
-PowerApps offers users, businesses, independent software vendors (ISVs), and systems integrators (SIs) a powerful platform for building line-of-business apps. The new addition to PowerApps in this release is the expansion of the Common Data Service, now called Common Data Service which now contains the core functionality of the Dynamics 365 Customer Engagement platform that powers Dynamics 365 for Sales, Marketing, Customer Service.
+PowerApps offers users, businesses, independent software vendors (ISVs), and systems integrators (SIs) a powerful platform for building line-of-business apps. **Common Data Service** is the underlying data platform for PowerApps that contains the core functionality of [Dynamics 365 for Customer Engagement platform](/dynamics365/customer-engagement/developer/developer-guide) such as server-side logic (plug-ins and workflows), business process flows, a highly sophisticated security model, and an extensible platform for developers to build apps. 
 
 > [!NOTE]
-> If you are already experienced with the Dynamics 365 for Sales, Marketing, or Customer Service apps, you will find that you will be able to apply your experience to customize and extend Common Data Service.
+> This effectively means that Common Data Service is also the underlying platform for Customer Engagement apps such as Dynamics 365 for Sales, Dynamics 365 for Customer Service, and Dynamics 365 for Marketing. If you are already experienced with Dynamics 365 for Customer Engagement apps, you will will be able to apply your experience to customize and extend Common Data Service to build apps. 
+
+There are many aspects to how developers can contribute to creating apps that use Common Data Service. While it is possible to build an application with code using Common Data Service as your data source, most projects will use either [model-driven apps](/powerapps/maker/model-driven-apps/model-driven-app-overview) or [canvas apps](/powerapps/maker/canvas-apps/getting-started) to generate the experience that people will use. 
+
+## Working with model-driven apps
+
+Model-driven apps are built on Common Data Service, and can only connect to a Common Data Service environment. All the data that defines a model-driven app is stored within Common Data Service.
+
+Model-driven apps share the method of distributing customizations and extensions used by Common Data Service using [Solutions](introduction-solutions.md).
+
+Model driven apps also have a number of points for developers to write code to extend. For information on what developers can do with model-driven apps, see [Model-driven apps Developer Guide](../model-driven-apps/overview.md)
+
+## Understand when to write code
+
+Because Common Data Service includes many capabilities for people to configure custom business logic without writing code, the most common scenarios for developers to contribute involve filling spaces in-between where existing features may not provide functionality you need to meet a requirement. Fortunately, Common Data Service provides many points for developers to extend the common functionality using code.
+
+For a developer who will contribute to projects it is important that they understand what can be done without writing code. You should familiarize yourself with these capabilities. More information: [What is Common Data Service?](../../maker/common-data-service/data-platform-intro.md) 
+
+## Content for on-premises deployments
+
+Common Data Service is not available for on-premise deployments at this time. Content in this guide does not include information about options that are only available for on-premises or internet facing deployments (IFD). For information related to these options, see the [Developer Guide for Dynamics 365 for Customer Engagement apps](/dynamics365/customer-engagement/developer/developer-guide).
 
 > [!div class="nextstepaction"]
 > [Get started](get-started-cds-developers.md)
 
 ### See also
 
-[PowerApps for developers](/powerapps/#pivot=home&panel=developer)
+[PowerApps for developers](/powerapps/#pivot=home&panel=developer)<br/>
+[Model-driven apps Developer Guide](../model-driven-apps/overview.md)