Merge pull request #308902 from prasadko/ai-assisted-update-test

v-shils · web-flow · commit 4d80a4df617e · 2025-12-01T12:59:50.000-08:00
Copy editing changes and customer feedback notes for MPC Pro docs
diff --git a/articles/planetary-computer/create-collection-web-interface.md b/articles/planetary-computer/create-collection-web-interface.md
@@ -5,15 +5,14 @@ author: beharris
 ms.author: brentharris
 ms.service: planetary-computer-pro
 ms.topic: quickstart
-ms.date: 05/08/2025
+ms.date: 12/01/2025
 #customer intent: As a user of geospatial data, I want to create a STAC collection so that I can organize metadata for geospatial assets for later querying.
 ms.custom:
-  - build-2025
 ---
 
 # Quickstart: Create a collection with the Microsoft Planetary Computer Pro web interface
 
-This quickstart explains how to create a collection in Microsoft Planetary Computer Pro via the web interface.
+This quickstart explains how to create a collection in Microsoft Planetary Computer Pro through the web interface.
 
 ## Prerequisites
 
@@ -24,11 +23,11 @@ To complete this quickstart, you need:
 
 ## Navigating the Microsoft Planetary Computer Pro web interface
 
-The Microsoft Planetary Computer Pro web interface is a web-based platform that allows you to manage your geospatial data. **You can access the web interface by using the URI provided in your GeoCatalog resource in Azure portal:**
+The Microsoft Planetary Computer Pro web interface is a web-based platform that you use to manage your geospatial data. **Access the web interface by using the URI provided in your GeoCatalog resource in Azure portal:**
 
 [ ![Screenshot of URI in geocatalog resource in Azure portal.](media/geocatalog-uri-example.jpeg) ](media/geocatalog-uri-example.jpeg#lightbox) 
 
-Upon entering the web interface, you land on the Planetary Computer Pro page, showing your recent collections (if any) and a button to create a new one.
+When you enter the web interface, you land on the Planetary Computer Pro page. The page shows your recent collections (if any) and a button to create a new one.
 
 [ ![Screenshot of Planetary Computer Pro landing page.](./media/landing-page.jpeg) ](./media/landing-page.jpeg#lightbox)
 
@@ -46,7 +45,7 @@ The **Explorer** page is where you can visualize your data on a map. Here, you c
 
 ## Create a collection
 
-1. Whether you are on the Planetary Computer Pro landing page or the Collections page, you can select the **Create Collection** button. This takes you to the **Create Collection** panel, where you enter the details of your collection in JSON format adhering to the [STAC specification](https://github.com/radiantearth/stac-spec/blob/master/collection-spec/collection-spec.md).
+1. From the Planetary Computer Pro landing page or the Collections page, select the **Create Collection** button to open the **Create Collection** panel. In the panel, enter the details of your collection in JSON format adhering to the [STAC specification](https://github.com/radiantearth/stac-spec/blob/master/collection-spec/collection-spec.md).
 
 [ ![Screenshot of Create Collection panel.](./media/create-collection-panel.jpeg) ](./media/create-collection-panel.jpeg#lightbox)
 
@@ -56,37 +55,39 @@ The **Explorer** page is where you can visualize your data on a map. Here, you c
     OR
     * Upload a collection JSON from your local machine 
 
-> [!NOTE] 
-> Whichever method you use to create your STAC collection, your JSON file must include the following fields:
-> 
-> | Field           | Required             | Description                                                                 |
-> |-----------------|----------------------|-----------------------------------------------------------------------------|
-> | `type`          | **Required**         | The type of the STAC object, which should be set to `Collection`.           |
-> | `stac_version`  | **Required**         | The version of the STAC specification that your collection adheres to.      |
-> | `stac_extensions`|                      | A list of STAC extensions that your collection uses.                        |
-> | `id`            | **Required**         | A unique identifier for your collection.                                    |
-> | `title`         |                      | A one-line title for your collection.                                       |
-> | `description`   | **Required**         | A description of your collection.                                           |
-> | `keywords`      |                      | A list of keywords that describe your collection.                           |
-> | `license`       | **Required**         | The license under which your collection is published.                       |
-> | `providers`     |                      | A list of providers capturing or processing the data for your collection.   |
-> | `extent`        | **Required**         | The spatial and temporal extent of your collection.                         |
-> | `summaries`     | **Strongly recommended** | A map of property summaries, either a set or range of values.             |
-> | `links`         | **Required**         | A list of links for your collection.                                        |
-> | `assets`        |                      | A dictionary of asset objects for your collection, each with unique keys. |
-> | `item_assets`   | [**Required for Visualization**](./render-configuration.md#step-1-define-item_assets-in-your-collection-json)                     | A dictionary of assets that can be found in member items.                   |
+The following table describes the standard STAC collection fields. Fields marked as **Required** must be included in your collection. You can also add custom fields as needed.
+
+| Field           | Required             | Description                                                                 |
+|-----------------|----------------------|-----------------------------------------------------------------------------|
+| `type`          | **Required**         | The type of the STAC object, which should be set to `Collection`.           |
+| `stac_version`  | **Required**         | The version of the STAC specification that your collection adheres to.      |
+| `stac_extensions`|                      | A list of STAC extensions that your collection uses.                        |
+| `id`            | **Required**         | A unique identifier for your collection.                                    |
+| `title`         |                      | A one-line title for your collection.                                       |
+| `description`   | **Required**         | A description of your collection.                                           |
+| `keywords`      |                      | A list of keywords that describe your collection.                           |
+| `license`       | **Required**         | The license for your STAC collection.                       |
+| `providers`     |                      | A list of providers capturing or processing the data for your collection.   |
+| `extent`        | **Required**         | The spatial and temporal extent of your collection.                         |
+| `summaries`     | **Strongly recommended** | A map of property summaries, either a set or range of values.             |
+| `links`         | **Required**         | A list of links for your collection.                                        |
+| `assets`        |                      | A dictionary of asset objects for your collection, each with unique keys. |
+| `item_assets`   | [**Required for Visualization**](./render-configuration.md#step-1-define-item_assets-in-your-collection-json)                     | A dictionary of assets that can be found in member items.                   |
+
+> [!NOTE]
+> The `item_assets` keys in the STAC collection should match the asset keys present in your STAC items. Mismatches can cause incorrect asset display.
 
 3. Once the JSON is complete, select the **Create** button to create your collection. This selection takes you to the **Overview** tab of your collection, where you can view and edit your collection's metadata, manage your data ingestions, and [configure your collection for visualization in the Explorer](./collection-configuration-concept.md).
 
 [ ![Screenshot of Collection overview page.](./media/collection-overview.jpeg) ](./media/collection-overview.jpeg#lightbox)
 
 ## Next steps
-Now that you have a collection, you can now ingest data into it. 
+Now that you have a collection, you can ingest data into it. 
 
 > [!div class="nextstepaction"]
 > [Quickstart: Ingesting data in the Microsoft Planetary Computer Pro web interface](./ingest-via-web-interface.md)
 
-## Related Content
+## Related content
 
 - [Quickstart: Create a STAC collection with Microsoft Planetary Computer Pro GeoCatalog using Python](./create-stac-collection.md)
 - [Configure your collection for visualization in the Explorer](./collection-configuration-concept.md)
diff --git a/articles/planetary-computer/get-started-planetary-computer.md b/articles/planetary-computer/get-started-planetary-computer.md
@@ -5,15 +5,14 @@ author: prasadko
 ms.author: prasadkomma
 ms.service: planetary-computer-pro
 ms.topic: get-started
-ms.date: 05/08/2025
+ms.date: 12/01/2025
 #customer intent: As a new customer, I want to learn how to use Microsoft Planetary Computer Pro to solve my geospatial data management challenges.
 ms.custom:
-  - build-2025
 ---
 
 # Get started with Microsoft Planetary Computer Pro
 
-Microsoft Planetary Computer Pro is an Azure cloud service for storing, cataloging, and securely distributing geospatial data across an enterprise. This Get Started guide assists you with the basics of deploying the service and creating your first [SpatioTemporal Asset Catalog (STAC) Collection](./stac-overview.md) to store and distribute your geospatial data. 
+Microsoft Planetary Computer Pro is an Azure cloud service for storing, cataloging, and securely distributing geospatial data across an enterprise. This article helps you with the basics of deploying the service and creating your first [SpatioTemporal Asset Catalog (STAC) Collection](./stac-overview.md) to store and distribute your geospatial data. 
 
 ## Prerequisites
 
@@ -29,90 +28,90 @@ Microsoft Planetary Computer Pro is an Azure cloud service for storing, catalogi
 | [Configure Your STAC Collection for Visualization](#configure-your-stac-collection-for-visualization) | [Concept: STAC Collection Configuration & Visualization](./configure-collection-web-interface.md)  |
 | [Connect and Build Applications with your Data](#connect-and-build-applications-with-your-data) | [Connect and Build Applications with Your Data](./build-applications-with-planetary-computer-pro.md) |
 
-## Deploy a GeoCatalog Resource in your Azure Subscription
+## Deploy a GeoCatalog resource in your Azure subscription
 
 A Microsoft Planetary Computer Pro deployment is called a GeoCatalog and is available to deploy through the Azure portal. 
 
-To deploy a GeoCatalog, navigate to the [Azure portal](https://portal.azure.com/) and search for "GeoCatalog"
+To deploy a GeoCatalog, go to the [Azure portal](https://portal.azure.com/) and search for "GeoCatalog"
 
 [ ![Screenshot of searching for GeoCatalogs in the Azure portal.](media/search-for-geocatalogs.png) ](media/search-for-geocatalogs.png#lightbox)
 
-Full details of the deployment process are available in the [Deploy GeoCatalog Quickstart](./deploy-geocatalog-resource.md).
+For more information about the deployment process, see the [Deploy GeoCatalog Quickstart](./deploy-geocatalog-resource.md).
 
-Once the service is deployed, access to the GeoCatalog resource can be controlled through the **Access control (IAM)** tab in the left sidebar:
+After you deploy the service, you can control access to the GeoCatalog resource through the **Access control (IAM)** tab in the left sidebar:
 
 [ ![Screenshot of the Access control (IAM) tab in the Azure portal, showing options to manage role assignments.](media/role-based-access-control-identity-access-management-blade.png) ](media/role-based-access-control-identity-access-management-blade.png#lightbox)
 
-More details on the **GeoCatalog Administrator** and **GeoCatalog Reader** roles are available in [Manage Access](./manage-access.md) documentation.
+For more information about the **GeoCatalog Administrator** and **GeoCatalog Reader** roles, see [Manage Access](./manage-access.md).
 
 ## Create a STAC Collection to organize your data
 
-All data managed in Microsoft Planetary Computer Pro is organized into groupings conforming to the [STAC Collection standard.](./stac-overview.md#stac-collections) 
+All data managed in Microsoft Planetary Computer Pro is organized into groupings that conform to the [STAC Collection standard](./stac-overview.md#stac-collections). 
 
-To create a new STAC Collection, open the GeoCatalog web interface by clicking on the GeoCatalog URI link on the Resource overview page in the Azure Portal. After opening the web interface, select the **Create collection** button:
+To create a new STAC Collection, open the GeoCatalog web interface by selecting the GeoCatalog URI link on the Resource overview page in the Azure portal. After opening the web interface, select the **Create collection** button:
 
 [ ![Screenshot of the Create collection button in the GeoCatalog web interface.](media/create-collection-button.png) ](media/create-collection-button.png#lightbox)
 
-More details setting up your STAC collection can be found in the [Create Collection from the Web Interface](./create-collection-web-interface.md) and [Create Collection from the API](./create-stac-collection.md) quickstarts. 
+For more information about setting up your STAC collection, see the [Create Collection from the Web Interface](./create-collection-web-interface.md) and [Create Collection from the API](./create-stac-collection.md) quickstarts. 
 
-## Ingest Data into a STAC Collection
+## Ingest data into a STAC collection
 
-[Ingestion](./ingestion-overview.md) is the process of copying your data from an external data store to your GeoCatalog resource and cataloging it. Data that isn't in a cloud-optimized format is converted into cloud-optimized format during ingestion. 
+[Ingestion](./ingestion-overview.md) is the process of copying your data from an external data store to your GeoCatalog resource and cataloging it. During ingestion, the process converts data that isn't in a cloud-optimized format into a cloud-optimized format. 
 
-The recommended and most secure method for ingesting data is to have the data stored in Azure Blob Storage and for you to provide read access to Blob Storage container using Managed Identity. 
+The recommended and most secure method for ingesting data is to store the data in Azure Blob Storage and provide read access to the Blob Storage container by using Managed Identity. 
 
 >[!WARNING]
 >All data ingested into Planetary Computer Pro requires [STAC Items](./stac-overview.md#introduction-to-stac-items). 
 
 >[!TIP]
-> To accelerate the creation of STAC Items, we have a [detailed tutorial](./create-stac-item.md) and also have an open source tool called STAC Forge.
+> To accelerate the creation of STAC Items, use the [detailed tutorial](./create-stac-item.md) and the open source tool called STAC Forge.
 
 [ ![Diagram illustrating the secure data ingestion process into Microsoft Planetary Computer Pro using Azure Blob Storage and Managed Identity.](media/ingestion-secure.png) ](media/ingestion-secure.png#lightbox)
 
-### Get your data ready for Ingestion
+### Get your data ready for ingestion
 > [!div class="checklist"]
 > * [Set up Managed Identity Access to your Azure Blob Storage](./set-up-ingestion-credentials-managed-identity.md)
 > * [Create STAC Items for your data](./create-stac-item.md)
-> * Ingest Your Data a [single item at a time](./add-stac-item-to-collection.md) or through [bulk ingestion](./bulk-ingestion-api.md)
+> * Ingest your data a [single item at a time](./add-stac-item-to-collection.md) or through [bulk ingestion](./bulk-ingestion-api.md)
 
 
-## Configure Your STAC Collection for Visualization
+## Configure your STAC Collection for visualization
 
-Ingested data can be visualized both in the built-in [Data Explorer](./use-explorer.md) or through your own applications. 
+You can visualize ingested data in the built-in [Data Explorer](./use-explorer.md) or through your own applications. 
 
 >[!NOTE]
-> A STAC Collection must be configured to support visualization before it is visible in the Data Explorer. 
+> You must configure a STAC Collection to support visualization before it appears in the Data Explorer. 
 
-Planetary Computer Pro's Tiler service [requires configuration](./collection-configuration-concept.md) to properly display your ingested data. All of these configuration options are available under the **Configuration** tab in the STAC Collection view:
+Planetary Computer Pro's Tiler service [requires configuration](./collection-configuration-concept.md) to properly display your ingested data. You can find all of these configuration options under the **Configuration** tab in the STAC Collection view:
 
 [ ![Screenshot of the Configure collection button in the GeoCatalog web interface.](media/configure-collection-button.png) ](media/configure-collection-button.png#lightbox)
 
-### Get your STAC Collection ready for Visualization
+### Get your STAC Collection ready for visualization
 > [!div class="checklist"]
 > * [Review Supported Data Types](./supported-data-types.md)
 > * [Configure Mosaic Settings](./mosaic-configurations-for-collections.md)
 > * [Set up Rendering](./render-configuration.md)
 > * [Adjust Tile Settings](./tile-settings.md)
 
 
-## Connect and Build Applications with your Data
+## Connect and build applications with your data
 
-Once data has been ingested, it's available for use in [applications inside and outside of Microsoft Planetary Computer Pro](./build-applications-with-planetary-computer-pro.md). 
+After you ingest data, you can use it in [applications inside and outside of Microsoft Planetary Computer Pro](./build-applications-with-planetary-computer-pro.md). 
 
-Data that is [configured for visualization](./configure-collection-web-interface.md) can be searched and viewed through the [Data Explorer tab](./use-explorer.md).  
+If you [configure data for visualization](./configure-collection-web-interface.md), you can search and view it through the [Data Explorer tab](./use-explorer.md).  
 
 [ ![Screenshot showing where the Data Explorer tab is.](media/explorer-link.png) ](media/explorer-link.png#lightbox)
 
-Data can also be accessed directly using the [GeoCatalog APIs](/rest/api/planetarycomputer). For details on establishing permissions for your applications, review the [Application Authentication](./application-authentication.md) documentation. 
+You can also access data directly by using the [GeoCatalog APIs](/rest/api/planetarycomputer). For details on establishing permissions for your applications, review the [Application Authentication](./application-authentication.md) documentation. 
 
 Planetary Computer Pro supports [connecting collections to ESRI's ArcGIS Pro Service](./create-connection-arc-gis-pro.md) to enable GIS-type work flows. 
 You can also use [QGIS](./configure-qgis.md) to work with your GeoCatalog data in an open-source desktop GIS.
 
 ## Get help
 
 1. Review the [rest of the documentation](/azure/planetary-computer) for relevant articles
-2. [Check out Microsoft Q&A](/answers/tags/775/planetary-computer-pro) to ask a question or find answers from others
-3. [File a Support Ticket](https://azure.microsoft.com/support/create-ticket)
+1. [Check out Microsoft Q&A](/answers/tags/775/planetary-computer-pro) to ask a question or find answers from others
+1. [File a Support Ticket](https://azure.microsoft.com/support/create-ticket)
 
 
 ## Next steps
diff --git a/articles/planetary-computer/stac-overview.md b/articles/planetary-computer/stac-overview.md
