Merge pull request #270010 from ShawnJackson/data-manager-for-agri-concepts

[AQ] edit pass: Azure Data Manager for Agriculture conceptual articles and release notes

Author: paulth1

articles/data-manager-for-agri/concepts-farm-operations-data.md

@@ -1,27 +1,32 @@
 ---
-title: Working with Farm Activities data in Azure Data Manager for Agriculture
-description: Learn how to integrate with Farm Activities data providers and ingest data into ADMA 
+title: Work with farm activities data in Azure Data Manager for Agriculture
+description: Learn how to integrate with data providers for farm activities and ingest data into Azure Data Manager for Agriculture. 
 author: lbpudi
 ms.author: lbethapudi
 ms.service: data-manager-for-agri
 ms.topic: conceptual
 ms.date: 08/14/2023
 ms.custom: template-concept
 ---
-# Working with Farm Activities data in Azure Data Manager for Agriculture
-Farm Activities data is one of the most important ground truth datasets in precision agriculture. It's these machine-generated reports that preserve the record of what exactly happened where and when that is used to both improve in-field practice and the downstream values chain analytics cases
+# Work with farm activities data in Azure Data Manager for Agriculture
 
-The Data Manager for Agriculture supports both
-* summary data - entered as properties in the operation data item directly
-* precision data - (for example, a .shp, .dat, .isoxml) uploaded as an attachment file and reference linked to the operation data item. 
+Data about farm activities is one of the most important ground-truth datasets in precision agriculture. These machine-generated reports preserve the record of exactly what happened and when. That record can help improve in-field practice and the downstream value-chain analytics.
+
+Azure Data Manager for Agriculture supports both:
+
+* **Summary data**: Entered as properties directly in the operation data item.
+* **Precision data**: Uploaded as an attachment file (for example, .shp, .dat, or .isoxml) and reference linked to the operation data item.
+
+New operation data can be pushed into the service via the APIs for operation and attachment creation. Or, if the desired source is in the supported list of original equipment manufacturer (OEM) connectors, data can be synced automatically from providers like Climate FieldView with an ingestion job for farm operations.
 
-New operation data can be pushed into the service via the APIs for operation and attachment creation. Or, if the desired source is in the supported list of OEM connectors, data can be synced automatically from providers like Climate FieldView with a farm operation ingestion job.
 [!INCLUDE [public-preview-notice.md](includes/public-preview-notice.md)]
-* Azure Data Manager for Agriculture supports a range of Farm Activities data that can be found [here](/rest/api/data-manager-for-agri/#farm-activities)
 
-## Integration with farm equipment manufacturers
-Azure Data Manager for Agriculture fetches the associated Farm Activities data (planting, application, tillage & harvest) from the data provider (Ex: Climate FieldView) by creating a Farm Activities data ingestion job. Look [here](./how-to-ingest-and-egress-farm-operations-data.md) for more details.
+Azure Data Manager for Agriculture supports a range of data about farm activities. For more information, see [What is Azure Data Manager for Agriculture?](/rest/api/data-manager-for-agri).
+
+## Integration with manufacturers of farm equipment
+
+Azure Data Manager for Agriculture fetches the associated data about farm activities (planting, application, tillage, and harvest) from the data provider (for example, Climate FieldView) by creating a data ingestion job for farm activities. For more information, see [Working with farm activities and activity data in Azure Data Manager for Agriculture](./how-to-ingest-and-egress-farm-operations-data.md).
 
 ## Next steps
 
-* Test our APIs [here](/rest/api/data-manager-for-agri).
+* [Test the Azure Data Manager for Agriculture REST APIs](/rest/api/data-manager-for-agri)

articles/data-manager-for-agri/concepts-hierarchy-model.md

@@ -1,6 +1,6 @@
 ---
 title: Hierarchy model in Azure Data Manager for Agriculture 
-description: Provides information on the data model to organize your agriculture data. 
+description: Get information on the data model to organize your agriculture-related data. 
 author: gourdsay
 ms.author: angour
 ms.service: data-manager-for-agri
@@ -9,48 +9,62 @@ ms.date: 08/22/2023
 ms.custom: template-concept
 ---
 
-# Hierarchy model to organize agriculture related data
+# Hierarchy model in Azure Data Manager for Agriculture
 
 [!INCLUDE [public-preview-notice.md](includes/public-preview-notice.md)]
 
-To generate actionable insights data related to growers, farms, and fields should be organized in a well defined manner. Firms operating in the agriculture industry often perform longitudinal studies and need high quality data to generate insights. Data Manager for Agriculture  organizes agronomic data in the below manner.
+To generate actionable insights, data related to growers, farms, and fields should be organized in a well-defined way. Firms that operate in the agriculture industry often perform longitudinal studies and need high-quality data to generate insights. Azure Data Manager for Agriculture  organizes agronomic data in the following hierarchy.
 
-:::image type="content" source="./media/data-model-v-2.png" alt-text="Screenshot showing farm hierarchy model.":::
-:::image type="content" source="./media/management-zones.png" alt-text="Screenshot showing management zones.":::
+:::image type="content" source="./media/data-model-v-2.png" alt-text="Screenshot that shows a farm hierarchy model.":::
+:::image type="content" source="./media/management-zones.png" alt-text="Screenshot that shows management zones.":::
 
-## Understanding farm hierarchy
+## Farm hierarchy
 
-### Party  
-* Party is the owner and custodian of any data related to their farm. You could imagine Party to be the legal entity that is running the business.  
-* The onus of defining the Party entity is with the customer setting up Data Manager for Agriculture. 
+### Party
+
+A party is the owner and custodian of any data related to a farm. You can think of a party as the legal entity that runs the business.  
+
+The customer who sets up Azure Data Manager for Agriculture defines the party entity.
 
 ### Farm
-* Farms are logical entities. A farm is a collection of fields. 
-* Farms don't have any geometry associated with them. Farm entity helps you organize your growing operations. For example, Contoso Inc is the Party that has farms in Oregon and Idaho.
+
+Farms are logical entities. A farm is a collection of fields.
+
+Farms don't have any geometry associated with them. A farm entity helps you organize your growing operations. For example, Contoso Ltd. is the party that has farms in Oregon and Idaho.
 
 ### Field
-* Fields denote a stable geometry that is in general agnostic to seasons and other temporal constructs. For example, field could be the geometry denoted in government records.
-* Fields are multi-polygon. For example, a road might divide the farm in two or more parts.
+
+Fields denote a stable geometry that's generally agnostic to seasons and other temporal constructs. For example, a field could be the geometry denoted in government records.
+
+Fields are multipolygons. For example, a road might divide the farm into two or more parts.
 
 ### Seasonal field
-* Seasonal field is the most important construct in the farming world. A seasonal fields definition includes the following things
-     * geometry
-     * Season 
-     * Crop
-* A seasonal field is associated with a field or a farm
-* In Data Manager for Agriculture, seasonal fields are mono crop entities. In cases where farmers are cultivating different crops simultaneously, they have to create one seasonal field per crop.
-* A seasonal field is associated with one season. If a farmer cultivates across multiple seasons, they have to create one seasonal field per season.
-* It's multi-polygon. Same crop can be planted in different areas within the farm.
+
+A seasonal field is the most important construct in the farming world. A seasonal field's definition includes:
+
+* Geometry
+* Season
+* Crop
+
+A seasonal field is:
+
+* Associated with a field or a farm.
+* A monocrop entity in Azure Data Manager for Agriculture. If farmers cultivate multiple crops simultaneously, they have to create one seasonal field per crop.
+* Associated with one season. If farmers cultivate across multiple seasons, they have to create one seasonal field per season.
+* A multipolygon. The same crop can be planted in various areas within the farm.
 
 ### Season
-* Season represents the temporal aspect of farming. It's a function of local agronomic practices, procedures and weather.
+
+The season represents the temporal aspect of farming. It's a function of local agronomic practices, procedures, and weather.
 
 ### Crop
-* Crop entity provides the phenotypic details of the planted crop.
+
+A crop entity provides the phenotypic details of the planted crop.
 
 ### Crop product
-* Crop Product entity refers to the commercial variety (brand, product) of the planted seeds. A seasonal field can contain information about various varieties of seeds planted (belonging to the same crop).
+
+A crop product is the commercial variety (brand and product) of the planted seeds. A seasonal field can contain information about varieties of seeds planted in the same crop.
 
 ## Next steps
 
-* Test our APIs [here](/rest/api/data-manager-for-agri).
+* [Test the Azure Data Manager for Agriculture REST APIs](/rest/api/data-manager-for-agri)