feat: Add specialized ApifyRequestQueue clients

docs/04_upgrading/upgrading_to_v3.md

@@ -52,3 +52,21 @@ async def main():
 ## Storage clients
 
 <!-- TODO -->
+
+## The default use of optimized ApifyRequestQueueClient
+
+- The default client for working with Apify platform based `RequestQueue` is now optimized and simplified client which does significantly lower amount of API calls, but does not support multiple consumers working on the same queue. It is cheaper and faster and is suitable for the majority of the use cases.
+- The full client is still available, but it has to be explicitly requested via `access="shared"` argument when using the `ApifyStorageClient`.
+
+**Now (v3.0):**
+
+```python
+from apify.storages import RequestQueue
+from apify.storage_clients import ApifyStorageClient
+
+async def main():
+   # Full client that supports multiple consumers of the Apify Request Queue
+    rq_shared = await RequestQueue.open(storage_client=ApifyStorageClient(access="shared"))
+    # Default optimized client that expects only single consumer of the Apify Request Queue
+    rq_single = await RequestQueue.open(storage_client=ApifyStorageClient())
+```