merge and update about catalogs

Author: meganelepalud-akeneo

content/apps/catalogs.md

@@ -2,22 +2,14 @@
 
 ## Overview
 
-<<<<<<< HEAD
-This guide introduces the catalog feature and explains why using catalogs to retrieve Akeneo data. 
-=======
-This guide introduces the catalog feature. With catalogs, you will save time during development because Akeneo PXM Studio
-will manage your **product selection** and give you direct access to the relevant data.
-With catalogs, you don't need to develop interfaces about filtering products, locales or attributes.
->>>>>>> e6e4c6c0ebf5c8f6f6d3274d2066a8812d80227a
+This guide introduces the catalog feature and explains why using catalogs to retrieve Akeneo data.  
+You will save time during development with catalogs because Akeneo PXM Studio manages your **product selection** and gives you direct access to the relevant data.
 
 ### What's a catalog?
 
-A catalog is a selection of products defined by one or several criteria. (families, categories, ...)
+A catalog is a selection of products defined by one or several criteria (families, categories, etc.)
 
-Catalogs are only created by apps and are configured by Akeneo users themselves from Akeneo PXM Studio. This feature is
-only visible if the app manage catalogs.
-
-![Catalogs](../img/apps/catalogs-list.png)
+Catalogs are only created by apps and configured by Akeneo users from Akeneo PXM Studio. This feature is only visible if the app manages catalogs.
 
 ![Catalogs for apps](../img/apps/app-catalog-list.png)
 
@@ -33,23 +25,20 @@ Moreover, with catalogs, you don't have to master the entire PIM structure anymo
 
 ### Limits
 
-::: warning
-You can only create **up to 15 catalogs** per app.
-:::
+To ensure Akeneo PXM Studio remains stable, we added some limits to catalogs:
+- Each app can create up to **15 catalogs**.
+- A product selection can have up to **25 selection criteria**.
+
 
 ### Next steps
 
 - Learn [how to create and use catalogs](/apps/catalogs.html#getting-started-with-catalogs)
 - Discover [how users configure catalogs](https://help.akeneo.com/pim/serenity/articles/how-to-connect-my-pim-with-apps.html#how-to-configure-catalogs-for-apps) in the Akeneo PXM Studio
 
-## Getting started with catalogs
-
-This guide describes how to use the catalog features with your app. 
-<!-- - Discover how users configure catalogs in the Akeneo PXM Studio TODO Add link -->
 
 ## Getting started with catalogs
 
-To create and use a catalog, an app must send some requests to the PIM REST API.
+To create and use a catalog, your app has to send some requests to the Akeneo REST API. This guide describes how to use the catalog features with your app. 
 
 ### What you'll learn
 
@@ -58,53 +47,54 @@ After completing this tutorial, you'll be able to create and use catalogs to ret
 ### Requirements
 
 - You have a Partner account and a developer sandbox.
-- Your app already manages the authorization step
-- You have an app able to use the authorization process.
+- Your app already manages the authorization process.
 
 ### Step 1: Ask for catalog scopes
 
-In the documentation [Ask for authorizations](/apps/authentication-and-authorization.html#step-2-ask-for-authorizations), 
-you discovered how to ask for scopes.
-
-If you want to manage catalogs, you need to ask for at least 4 scopes:
+To manage catalogs, you need to ask for at least 4 scopes:
 - `read_products`
 - `read_catalogs`
 - `write_catalogs`
 - `delete_catalogs`
 
-Once these scopes are accepted by Akeneo users during the installation of your app, you will be able to manage and use
-catalogs.
+In the documentation [Ask for authorizations](/apps/authentication-and-authorization.html#step-2-ask-for-authorizations), 
+you can discover how to ask for scopes.
+
+Once Akeneo users accept these scopes during the app connection, you will be able to manage and use catalogs.
 
 ### Step 2: Create catalogs
 
-Checkout the [Create a new catalog](/api-reference.html#post_app_catalog) endpoint documentation to find out how
-to create one.
+Once your app is connected and gets the proper authorization, your app can start using catalogs. 
+
+To do so, your app has to create a catalog using the [Create a new catalog](/api-reference.html#post_app_catalog) endpoint. 
+When your app creates a catalog, the API returns its UUID. You will use this catalog UUID to get information about the catalog and retrieve related products.
 
-By default, when you create a catalog in the Akeneo PXM Studio, the catalog is disabled. It means that until a user hasn't enabled it, you won't be able to retrieve products for this catalog. Note that only users can enable a catalog. 
-::: info
-You should create a catalog with the more descriptive name possible. It will help your users to know how to configure it.
+::: tips
+To help your users know how to configure a catalog, give it the most descriptive name possible.
 :::
 
-Catalogs created **are always disabled by default** in the Akeneo PXM Studio. Only Akeneo users are able to enable a 
-catalog. You must wait for any of your users to enable it before using it.
+By default, new catalogs are **disabled**. 
+It means that until a user hasn't enabled it, you won't be able to retrieve products for this catalog. 
+
+Please note that only users can enable a catalog. 
+![Catalog settings](../img/apps/catalogs-settings.png)
 
-To help your users, you can give them a link to directly access the catalog configuration interface:
+To help your users, you can redirect them directly to the catalog configuration interface on their Akeneo PXM Studio using the following URL structure:
 
 ``` http
 
-https://my-pim.cloud.akeneo.com/connect/apps/v1/catalogs/{catalog id}
+https://my-pim.cloud.akeneo.com/connect/apps/v1/catalogs/{catalog_uuid}
 ```
 
-At any moment, you can verify if the catalog is enabled by calling the [get catalog endpoint](/api-reference.html#get_app_catalog).
+At any moment, you can verify if a catalog is enabled by calling the [get catalog endpoint](/api-reference.html#get_app_catalog).
 
 ### Step 3: Get products using catalogs
 
 ::: warning
-The endpoint for retrieving the list of product uuids will be available soon.
+The endpoint for retrieving the list of product UUIDs will be available soon!
 :::
 
-Once you have an enabled catalog, you will be able to paginate the corresponding product uuids using this
-[endpoint](/api-reference.html#Appcatalogproduct).
+Once you have an enabled catalog, you can paginate the corresponding product UUIDs using this [endpoint](/api-reference.html#Appcatalogproduct).
 
 ### Next steps
 - Learn [how to synchronize Akeneo data](/getting-started/synchronize-pim-products-6x/welcome.html)