Merge branch 'anneta-cdm2' of https://github.com/MicrosoftDocs/powerapps-docs-pr into anneta-cdm2

Author: AFTOwen

powerapps-docs/common-data-model/overview.md

@@ -1,65 +1,64 @@
 ---
 title: What is the Common Data Model | Microsoft Docs
-description: "Common Data Model is a standardized, modular, extensible collection of data schemas published by Microsoft that are designed to make it easier for you build, use, and analyze data."
+description: "Common Data Model is a standardized, modular, and extensible collection of data schemas that Microsoft published to help you build, use, and analyze data."
 author: RobertBruckner
 ms.service: powerapps
+ms.reviewer: anneta
 ms.topic: article
 ms.date: 07/24/2018
 ms.author: robruc
 ---
 
 # What is the Common Data Model?
 
-If you’ve ever run into challenges with data that’s *nearly* the same or *should* work together – then spent significant effort transforming fields and tables to work with your other data – you know that common data elements can save effort, streamline future development, and enable faster analytics. These capabilities and more are what the Common Data Model (CDM) can provide.
+If you’ve ever run into challenges with data that’s *nearly* the same or that *should* work together (and then spent significant effort transforming fields and tables to work with your other data), you know that common data elements can save effort, streamline development, and enable faster analytics. The Common Data Model (CDM) can provide these capabilities and more with products and services such PowerApps, Power BI, Dynamics 365, and Azure, storing data in conformance with the CDM. 
 
-The **Common Data Model (CDM)** is a standardized, modular, extensible collection of data schemas published by Microsoft that are designed to make it easier for you to build, use, and analyze data. This collection of predefined schemas—consisting of *entities*, *attributes*, *semantic metadata* and *relationships*—represent commonly used concepts and activities, such as Account and Campaign, to simplify the creation, aggregation, and analysis of data. More information: [CDM repo on GitHub](https://aka.ms/cdmrepo)
+The CDM is a standardized, modular, and extensible collection of data schemas that Microsoft published to help you to build, use, and analyze data. This collection of predefined schemas consists of entities, attributes, semantic metadata, and relationships. The schemas represent commonly used concepts and activities, such as **Account** and **Campaign**, to simplify the creation, aggregation, and analysis of data. This graphic shows some elements of those schemas. More information: [CDM repo on GitHub](https://aka.ms/cdmrepo)
 
 ![Common Data Model](media/cdm-entities.png)
 
 More information: [CDM poster](https://aka.ms/cdmposter)
 
 ## Why use the Common Data Model?
 
-The CDM simplifies data management and application development by unifying data into a known form, and by applying structural and semantic consistency across multiple applications and deployments. In other words, once your data is in the CDM, you can use it in many different applications, streamline the creation or use of other applications to make use of that existing data, and easily build reports for each of them (or all of them). In addition, data integrators who bring data from a variety of systems can focus on landing the data in the CDM, instead of building a new model for each application.
+The CDM simplifies data management and app development by unifying data into a known form and applying structural and semantic consistency across multiple apps and deployments. In other words, if your data is in the CDM, you can use it in many apps, streamline the creation or use of other apps to use that data, and easily build reports for each of those apps (or all of them). In addition, data integrators who bring data from a variety of systems can focus on landing the data in the CDM, instead of building a different model for each app.
 
-Imagine you have three business applications – a materials app, a manufacturing app, and a sales app. Often each of the applications would be created independently, with different structures representing an entity, such as *Account*, that are nearly the same (but not) . With the CDM, you could build your data in a standardized format (using the CDM entities, attributes, and relationships), and then each of those three apps could use the same data as a basis. Of course each app could have its own additional data and schemas, based on the functionality of each app. But when it comes to development, your applications and reports could pull the common data
-elements quickly, cleanly, and with confidence.
+Imagine that you have three business apps – one each for materials, manufacturing, and sales. Often each app would be created independently, with different structures that represent an entity, such as **Account**, in nearly the same way (but not quite). With the CDM, you could build your data in a standardized format (using the CDM entities, attributes, and relationships), and then each app could use the same data as a basis. Of course, each app could have its own additional data and schemas, based on its functionality. But when it comes to development, your apps and reports could pull the common data elements quickly, cleanly, and with confidence.
 
 And what about the need to create a fourth app? Your data is ready, in the CDM schema, so your development efforts can concentrate on
 business logic, not data quagmires and sticky transformations.
 
-In other words, the CDM offers the following for your data:
+In other words, the CDM offers these benefits:
 
 - **Structural and semantic consistency** across applications and deployments.
 
 - **Simplified integration and disambiguation of data** that’s collected from processes, digital interactions, product telemetry, people interactions, and so on.
 
-- **A unified shape** where data integrations can **combine existing enterprise data with other sources**, and use that data holistically to develop new applications or derive insights.
+- **A unified shape** where data integrations can **combine existing enterprise data with other sources** and use that data holistically to develop apps or derive insights.
 
-- **Ability to extend the schema and CDM entities** to tailor the Common Data Model to your organization.
+- **Ability to extend the schema and CDM entities** to tailor the CDM to your organization.
 
-You can use the CDM to create new data repositories that match the schema, and you can also transform your existing data into the Common
-Data Model schema. Either way, the efficiency you get from standardization can expedite and streamline whatever you do next with your data.
+You can use the CDM to create data repositories that match the schema, and you can also transform your existing data into the CDM schema. Either way, the efficiency that you get from standardization can expedite and streamline whatever you do next with your data.
 
 ## Who uses the Common Data Model?
 
-The CDM is used by a variety of customers, partners and products all with the same goal of unifying data in well-known form with semantic meaning.
+A variety of customers, partners, and products use the CDM, and all have the same goal of unifying data in a well-known form with semantic meaning.
 
-- **Application Makers/Developers**: Whether these users leverage code-based platforms or a low-code/no-code platform like PowerApps, they need to store and manage data for their applications.
+- **App makers/developers**: Whether these users leverage code-based platforms or a low-code/no-code platform such as PowerApps, they need to store and manage data for their apps.
 
-- **Data Integrators**: These users are responsible for bringing data from a variety of systems to make it accessible for Applications to use.
+- **Data integrators**: These users are responsible for bringing data from a variety of systems to make it accessible for apps to use.
 
-Historically, the work to build an application has been tightly tied with data integration, but with the CDM and the platforms that support it, the two can happen independently.
+Historically, the work to build an app has been tightly tied with data integration, but with the CDM and the platforms that support it, the two can happen independently.
 
-## Common Data Model in action
+## The Common Data Model in action
 
-Microsoft and its partners use the CDM for their own applications and offerings, and are building additional services and offering
-based on CDM schemas. The following examples show how organizations use the CDM:
+Microsoft and its partners use the CDM for their own apps and offerings and are building additional services and offerings
+based on CDM schemas. These examples show how organizations use the CDM:
 
-- **Common Data Service (CDS) for Apps**, which supports Dynamics and PowerApps, stores data in conformances with the CDM definition. In fact, many of the original business entities including in the CDM came from Dynamics offerings such as Dynamics 365 for Sales and Dynamics 365 for Marketing.
+- **Common Data Service (CDS) for Apps**, which supports Dynamics and PowerApps, stores data in conformance with the CDM definition. In fact, many of the original business entities in the CDM came from Dynamics offerings, such as Dynamics 365 for Sales and Dynamics 365 for Marketing.
 
-- **Industry verticals** such as Healthcare are working closely with Microsoft to extend the CDM to their specific business concepts, such as *Patient* and *Care Plan*, so they can share data and build services so partners can easily exchange data, create interoperable apps and services, and create quick analytics that are easy to share.
+- **Industry verticals** such as healthcare are working closely with Microsoft to extend the CDM to their specific business concepts, such as **Patient** and **Care Plan**. That way, users can can share data and build services so partners can easily exchange data, create interoperable apps and services, and create quick analytics that are easy to share.
 
 ## Next step
 
-[How to use the Common Data Model](use-common-data-model.md): Describes the CDM in details, and discusses use cases for creating new data in CDM or transforming your existing data into CDM.
+[How to use the Common Data Model](use-common-data-model.md): Describes the CDM in detail and discusses use cases for creating data in the CDM or transforming your existing data into the CDM.

powerapps-docs/common-data-model/use-common-data-model.md

@@ -3,61 +3,56 @@ title: Development using the Common Data Model | Microsoft Docs
 description: "Provides information about how you can use the Common Data Model to develop apps and solutions."
 author: RobertBruckner
 ms.service: powerapps
+ms.reviewer: anneta
 ms.topic: article
 ms.date: 07/24/2018
 ms.author: robruc
 ---
 
 # How to use the Common Data Model
 
-With the **Common Data Model (CDM)**, you can put your data into formats that represent commonly used concepts and activities, and are broadly used and understood – so that you can query that data, reuse it, and interoperate with other businesses and applications that also use its format. Similar to knowing the size and shape of an AA battery so all your remote controls can use them, CDM defines the size and shape of a *Contact* (for example), so your application developers and business partners know how to that data and can build your apps (or interoperate) with agility and confidence. And since CDM is an open-source definition of standard entities, the community of interested developers can readily understand and participate in schema definitions.
+With the Common Data Model (CDM), you can put your data into formats that represent concepts and activities that are commonly used and well understood. That way, you can query that data, reuse it, and interoperate with other businesses and apps that use the same format. This strategy matches that of, for example, manufacturers who produce AA batteries that fit in most remote controls. The CDM defines the size and shape of, for example, a **Contact** so that your app developers and business partners can parse that data and build your apps (or interoperate) with agility and confidence. The CDM is an open-source definition of standard entities, so the community of interested developers can readily understand and participate in schema definitions.
 
-Today, CDM is used within the Common Data Service (CDS) for Apps, which supports Dynamics and PowerApps, and the data preparation capabilities in Power BI to create schematized files in Azure Data Lake.
+Today, the CDM is used within Common Data Service (CDS) for Apps, which supports Dynamics and PowerApps, and the data-preparation capabilities in Power BI to create schematized files in Azure Data Lake.
 
 ![Common Data Model with CDS for Apps](media/cdm-with-cds.png)
 
-You can use the CDM and CDS for Apps in the following ways:
+You can use the CDM and CDS for Apps in these ways:
 
-- **Securely store and manage your data in CDM format**: You can use the CDS for Apps to securely store and manage your data in the standardized CDM format. By doing so, you can then access and use that data in Microsoft apps and services such as Dynamics, Power Apps, Flow, or Power BI, or your own custom applications.
+- **Securely store and manage your data in the CDM format**: You can use CDS for Apps to securely store and manage your data in the standardized format of the CDM. By doing so, you can then access and use that data in Microsoft apps and services such as Dynamics, PowerApps, Microsoft Flow, Power BI, or your own custom apps.
 
-- **Create custom CDM entities**: The CDM is extensible, so you can create any entities not already in CDM that are specific to your organization, and populate those entities with your existing data using **Power Query**. This lets you take advantage of CDM, and also tailor it to your business.
+- **Create custom entities in the CDM**: The CDM is extensible, so you can create entities that are specific to your organization and populate them with your existing data using **Power Query**. With this approach, you can take advantage of the CDM and tailor it to your business.
 
-- **Create your own repositories of data**: You can build repositories of data that adhere to the **Common Data Model (CDM)** schema, and connect to those data sources using Microsoft data connectors. This lets you build custom line-of-business applications that use or share your CDM data, regardless of where the data originated or is stored.
+- **Create your own repositories of data**: You can build repositories of data that adhere to the schema of the CDM and connect to those data sources using Microsoft data connectors. This lets you build custom line-of-business apps that use or share your data in the CDM, regardless of where the data originated or is stored.
 
-- **Quickly derive and distribute insights using Power BI**: You can use advanced data preparation services in Power BI that access your CDM data stores (such as data you’ve put into CDS for Apps) to create reports and dashboards, and then create report-generating apps that automatically pull your CDM data into customized insights for individuals and groups in your organization.
+- **Quickly derive and distribute insights using Power BI**: You can use advanced data-preparation services in Power BI that access your data stores in the CDM (such as data that you’ve put into CDS for Apps) to create reports and dashboards. Then you can create report-generating apps that automatically pull your data from the CDM into customized insights for individuals and groups in your organization.
 
-- **Produce customized, but organization-wide reports in Power BI**: You can use apps that automatically generate customized reports that you can place into Power BI workspaces for users in your organization, and beyond.
+- **Produce customized, organization-wide reports in Power BI**: You can use apps that automatically generate customized reports that you can place into Power BI workspaces for users in your organization and beyond.
 
-As Microsoft continues to extend the CDM, in concert with many partners and subject matter experts, new industries such as the health
-care industry will be able to benefit from the CDM and the platforms that support it.
+Microsoft continues to extend the CDM in concert with many partners and subject-matter experts so that more industries, such as health
+care, can benefit from the CDM and the platforms that support it.
 
-## Data Integration and Power Query Online
+## Data integration and Power Query Online
 
-Both platforms that currently support CDM also offer data integration experiences through Power Query Online that allow users to bring in data from a variety of sources, transform if necessary and then map to standard CDM entities or create custom entities. Power Query Online leverages the same visual, self-service data prep experience as Power Query within Excel and Power BI Desktop, so existing users can ramp up quickly.
+Both platforms that currently support CDM also offer data-integration experiences through Power Query Online that allow users to bring in data from a variety of sources, transform it if necessary, and then map it to standard entities in the CDM or create custom entities. Power Query Online leverages the same visual, self-service data-prep experience as Power Query within Excel and Power BI Desktop, so existing users can ramp up quickly.
 
 ![Map data with entities in CDM](media/cdm-map-entities.png)
 
 ## Common Data Service for Apps
 
-CDS for Apps allows you to jumpstart apps using the CDM with business logic, security and integration built-in. The platform allows you
-to:
+By using CDS for Apps, you can jumpstart apps using the CDM with business logic, security, and integration already built in. The platform provides these benefits:
 
-- **Leverage packaged business applications**: Many Microsoft Dynamics solutions, and many third-party applications, are built on top of (or at least leverage) the CDS for Apps. When your data is in the CDM, you can take advantage of those packaged applications.
+- **Leverage packaged business applications**: Many Microsoft Dynamics solutions and third-party apps are built on top of (or at least leverage) CDS for Apps. When your data is in the CDM, you can take advantage of those packaged applications.
 
-- **Gain access to customized solutions**: An ecosystem of extensions and complete applications, created by developers who understand and work with data in the CDM format exists. See [introduction to solutions](https://docs.microsoft.com/powerapps/developer/common-data-service/introduction-solutions) for more information.
+- **Gain access to customized solutions**: Developers who understand and work with data in the CDM format have created an ecosystem of extensions and complete apps. For more information, see [introduction to solutions](https://docs.microsoft.com/powerapps/developer/common-data-service/introduction-solutions).
 
-Whatever your intent, the CDM puts your data into a common format so you can use, share, and analyze it more easily.
+Whatever your intent, the CDM puts your data into a common format so that you can use, share, and analyze it more easily.
 
 **Resources for CDS for Apps**
 
-- [What is CDS for Apps?](https://docs.microsoft.com/powerapps/maker/common-data-service/data-platform-intro)
-
-- [Add data to an entity in CDS for Apps by using Power Query](https://docs.microsoft.com/powerapps/maker/common-data-service/data-platform-cds-newentity-pq)
-
-- [Introduction to solutions](https://docs.microsoft.com/powerapps/developer/common-data-service/introduction-solutions)
-
-- [Build a model-driven app](https://docs.microsoft.com/powerapps/maker/model-driven-apps/model-driven-app-overview)
-
-- [Build a canvas app](https://docs.microsoft.com/powerapps/maker/canvas-apps/getting-started)
-
+- [What is CDS for Apps?](../maker/common-data-service/data-platform-intro.md)
+- [Add data to an entity in CDS for Apps by using Power Query](../maker/common-data-service/data-platform-cds-newentity-pq.md)
+- [Introduction to solutions](../developer/common-data-service/introduction-solutions.md)
+- [Build a model-driven app](../maker/model-driven-apps/model-driven-app-overview.md)
+- [Build a canvas app](../maker/canvas-apps/getting-started.md)
 - [Create a flow that uses CDS for Apps](https://docs.microsoft.com/flow/common-data-model-intro)