Description for DocumentProcessorServiceAsyncClient class

[gheduardo]

PLEASE READ: If you have a support contract with Google, please create an issue in the support console instead of filing on GitHub. This will ensure a timely response.

NOTE: Google Cloud Python client libraries are no longer maintained inside this repository. Please visit the python-API repository (e.g., https://github.com/googleapis/python-pubsub/issues) for faster response times.

See all published libraries in the README.

Descriptions for DocumentProcessorServiceAsyncClient and DocumentProcessorServiceClient class are exactly the same.
There is no clear description on what their differences are nor when to use them.
Moreover, the customers are growing confused since there is a limit of 10 pages per document processing when using DocumentProcessorServiceAsyncClient (except if using batch processing). See one more reference of the same in this Stack Overflow post:

https://stackoverflow.com/questions/71887957/400-document-pages-exceed-the-limit-page-limit-exceeded

This is shown in the public documentation here:
https://cloud.google.com/python/docs/reference/documentai/latest/google.cloud.documentai_v1.services.document_processor_service

These GitHub pages are the source of the above:

• DocumentProcessorServiceAsyncClient - packages/google-cloud-documentai/google/cloud/documentai_v1/services/document_processor_service/async_client.py
• DocumentProcessorServiceClient - packages/google-cloud-documentai/google/cloud/documentai_v1/services/document_processor_service/client.py

Request:

• Update class descriptions
• Add use case
• Add limitation of 10 pages per document when using DocumentProcessorServiceAsyncClient (except if using batch processing)

[ohmayr]

@gheduardo Thanks for reporting this issue. We are taking a look into this and will provide an update soon.