Added notes to the GetPartitions method

Modified the following files with notes to the `GetPartitions` method:

* VersionedLayerClient.h
* VolatileLayerClient.h
* dataservice-read-catalog-example.md

Relates-to: OLPEDGE-812

Signed-off-by: Halyna Dumych <[email protected]>

Author: HalynaDumych

docs/dataservice-read-catalog-example.md

@@ -256,6 +256,8 @@ auto request = olp::dataservice::read::PartitionsRequest()
 
 Then pass it to the appropriate layer client, i.e. `VersionedLayerClient` via `GetPartitions` method:
 
+> Note: If your layer has lots of partitions or uses TileKeys as partition IDs, then this operation can fail because of the large amount of data.
+
 ```cpp
 // Create appropriate layer client with HRN, layer name and settings.
 olp::dataservice::read::VersionedLayerClient layer_client(

olp-cpp-sdk-dataservice-read/include/olp/dataservice/read/VersionedLayerClient.h

@@ -150,6 +150,8 @@ class DATASERVICE_READ_API VersionedLayerClient final {
   /**
    * @brief Fetches a list of partitions for the given generic layer
    * asynchronously.
+   * @note If your layer has lots of partitions or uses TileKeys as
+   * partition IDs, then this operation can fail because of the large amount of data.
    * @param partitions_request Contains the complete set of the request
    * parameters.
    * @note GetLayerId value of the \c PartitionsRequest is ignored, and the
@@ -164,6 +166,8 @@ class DATASERVICE_READ_API VersionedLayerClient final {
   /**
    * @brief Fetches a list of partitions for the given generic layer
    * asynchronously.
+   * @note If your layer has lots of partitions or uses TileKeys as
+   * partition IDs, then this operation can fail because of the large amount of data.
    * @param partitions_request Contains the complete set of the request
    * parameters.
    * @note GetLayerId value of the \c PartitionsRequest is ignored, and the

olp-cpp-sdk-dataservice-read/include/olp/dataservice/read/VolatileLayerClient.h

@@ -98,6 +98,8 @@ class DATASERVICE_READ_API VolatileLayerClient final {
 
   /**
    * @brief Fetches a list partitions for given volatile layer asynchronously.
+   * @note If your layer has lots of partitions or uses TileKeys as
+   * partition IDs, then this operation can fail because of the large amount of data.
    * @param request contains the complete set of request parameters.
    * @param callback will be invoked once the list of partitions is available,
    * or an error is encountered.
@@ -108,6 +110,8 @@ class DATASERVICE_READ_API VolatileLayerClient final {
 
   /**
    * @brief Fetches a list partitions for given volatile layer asynchronously.
+   * @note If your layer has lots of partitions or uses TileKeys as
+   * partition IDs, then this operation can fail because of the large amount of data.
    * @param request contains the complete set of request parameters.
    * @return CancellableFuture, which when complete will contain the
    * PartitionsResponse or an error. Alternatively, the CancellableFuture can be