[formrecognizer] Readme fixes (Azure#18352)

* readme fixes

* fix snippet link

Author: catalinaperalta

sdk/formrecognizer/azure-ai-formrecognizer/README.md

@@ -9,7 +9,7 @@ from form documents. It includes the following main functionalities:
     * Receipt model - Recognize data from sales receipts using a prebuilt model.
     * Business card model - Recognize data from business cards using a prebuilt model.
     * Invoice model - Recognize data from invoices using a prebuilt model.
-    * Id document model - Recognize data from id documents using a prebuilt model.
+    * ID document model - Recognize data from ID documents using a prebuilt model.
 
 [Source code][python-fr-src] | [Package (PyPI)][python-fr-pypi] | [API reference documentation][python-fr-ref-docs]| [Product documentation][python-fr-product-docs] | [Samples][python-fr-samples]
 
@@ -139,7 +139,7 @@ form_recognizer_client = FormRecognizerClient(
     - Sales receipts. See fields found on a receipt [here][service_recognize_receipt].
     - Business cards. See fields found on a business card [here][service_recognize_business_cards].
     - Invoices. See fields found on an invoice [here][service_recognize_invoice].
-    - Id documents. See fields found on an id document [here][service_recognize_id_documents].
+    - ID documents. See fields found on an ID document [here][service_recognize_id_documents].
  - Recognizing form content, including tables, lines, words, and selection marks, without the need to train a model. Form content is returned in a collection of `FormPage` objects.
 
 Sample code snippets are provided to illustrate using a FormRecognizerClient [here](#recognize-forms-using-a-custom-model "Recognize Forms Using a Custom Model").
@@ -174,10 +174,7 @@ The following section provides several code snippets covering some of the most c
 
 * [Recognize Forms Using a Custom Model](#recognize-forms-using-a-custom-model "Recognize Forms Using a Custom Model")
 * [Recognize Content](#recognize-content "Recognize Content")
-* [Recognize Receipts](#recognize-receipts "Recognize receipts")
-* [Recognize Business Cards](#recognize-business-cards "Recognize business cards")
-* [Recognize Invoices](#recognize-invoices "Recognize invoices")
-* [Recognize Id Documents](#recognize-id-documents "Recognize id documents")
+* [Using Prebuilt Models](#using-prebuilt-models "Using Prebuilt Models")
 * [Train a Model](#train-a-model "Train a model")
 * [Manage Your Models](#manage-your-models "Manage Your Models")
 
@@ -260,8 +257,10 @@ for content in form_pages:
             ))
 ```
 
-### Recognize Receipts
-Recognize data from sales receipts using a prebuilt model. Receipt fields recognized by the service can be found [here][service_recognize_receipt].
+### Using Prebuilt Models
+Extract fields from certain types of common forms such as receipts, invoices, business cards, and identity documents using prebuilt models provided by the Form Recognizer service.
+
+For example, to extract fields from a sales receipt, use the prebuilt receipt model provided by the `begin_recognize_receipts` method:
 
 ```python
 from azure.ai.formrecognizer import FormRecognizerClient
@@ -290,81 +289,12 @@ for receipt in result:
             print("{}: {} has confidence {}".format(name, field.value, field.confidence))
 ```
 
-### Recognize Business Cards
-Recognize data from business cards using a prebuilt model. Business card fields recognized by the service can be found [here][service_recognize_business_cards].
-
-```python
-from azure.ai.formrecognizer import FormRecognizerClient
-from azure.core.credentials import AzureKeyCredential
-
-endpoint = "https://<region>.api.cognitive.microsoft.com/"
-credential = AzureKeyCredential("<api_key>")
-
-form_recognizer_client = FormRecognizerClient(endpoint, credential)
-
-with open("<path to your business card>", "rb") as fd:
-    business_card = fd.read()
-
-poller = form_recognizer_client.begin_recognize_business_cards(business_card)
-result = poller.result()
-
-for business_card in result:
-    for name, field in business_card.fields.items():
-        if name == "ContactNames":
-            print("ContactNames:")
-            for items in field.value:
-                for item_name, item in items.value.items():
-                    print("...{}: {} has confidence {}".format(item_name, item.value, item.confidence))
-        else:
-            for item in field.value:
-                print("{}: {} has confidence {}".format(item.name, item.value, item.confidence))
-```
-
-### Recognize Invoices
-Recognize data from invoices using a prebuilt model. Invoice fields recognized by the service can be found [here][service_recognize_invoice].
-
-```python
-from azure.ai.formrecognizer import FormRecognizerClient
-from azure.core.credentials import AzureKeyCredential
-
-endpoint = "https://<region>.api.cognitive.microsoft.com/"
-credential = AzureKeyCredential("<api_key>")
-
-form_recognizer_client = FormRecognizerClient(endpoint, credential)
-
-with open("<path to your invoice>", "rb") as fd:
-    invoice = fd.read()
-
-poller = form_recognizer_client.begin_recognize_invoices(invoice)
-result = poller.result()
-
-for invoice in result:
-    for name, field in invoice.fields.items():
-        print("{}: {} has confidence {}".format(name, field.value, field.confidence))
-```
-
-### Recognize Id documents
-Recognize data from id documents using a prebuilt model. Id document fields recognized by the service can be found [here][service_recognize_id_documents].
+You are not limited to receipts! There are a few prebuilt models to choose from, each of which has its own set of supported fields:
+- Analyze receipts through the `begin_recognize_receipts` method (fields recognized by the service can be found [here][service_recognize_receipt])
+- Analyze business cards through the `begin_recognize_business_cards` method (fields recognized by the service can be found [here][service_recognize_business_cards]).
+- Analyze invoices through the `begin_recognize_invoices` method (fields recognized by the service can be found [here][service_recognize_invoice]).
+- Analyze identity documents through the `begin_recognize_id_documents` method (fields recognized by the service can be found [here][service_recognize_id_documents]).
 
-```python
-from azure.ai.formrecognizer import FormRecognizerClient
-from azure.core.credentials import AzureKeyCredential
-
-endpoint = "https://<region>.api.cognitive.microsoft.com/"
-credential = AzureKeyCredential("<api_key>")
-
-form_recognizer_client = FormRecognizerClient(endpoint, credential)
-
-with open("<path to your id document>", "rb") as fd:
-    id_document = fd.read()
-
-poller = form_recognizer_client.begin_recognize_id_documents(id_document)
-result = poller.result()
-
-for id_document in result:
-    for name, field in id_document.fields.items():
-        print("{}: {} has confidence {}".format(name, field.value, field.confidence))
-```
 
 ### Train a model
 Train a custom model on your own form type. The resulting model can be used to recognize values from the types of forms it was trained on.
@@ -497,7 +427,7 @@ These code samples show common scenario operations with the Azure Form Recognize
 * Recognize receipts from a URL: [sample_recognize_receipts_from_url.py][sample_recognize_receipts_from_url]
 * Recognize business cards: [sample_recognize_business_cards.py][sample_recognize_business_cards]
 * Recognize invoices: [sample_recognize_invoices.py][sample_recognize_invoices]
-* Recognize id documents: [sample_recognize_id_documents.py][sample_recognize_id_documents]
+* Recognize ID documents: [sample_recognize_id_documents.py][sample_recognize_id_documents]
 * Recognize content: [sample_recognize_content.py][sample_recognize_content]
 * Recognize custom forms: [sample_recognize_custom_forms.py][sample_recognize_custom_forms]
 * Train a model without labels: [sample_train_model_without_labels.py][sample_train_model_without_labels]
@@ -516,7 +446,7 @@ are found under the `azure.ai.formrecognizer.aio` namespace.
 * Recognize receipts from a URL: [sample_recognize_receipts_from_url_async.py][sample_recognize_receipts_from_url_async]
 * Recognize business cards: [sample_recognize_business_cards_async.py][sample_recognize_business_cards_async]
 * Recognize invoices: [sample_recognize_invoices_async.py][sample_recognize_invoices_async]
-* Recognize id documents: [sample_recognize_id_documents_async.py][sample_recognize_id_documents_async]
+* Recognize ID documents: [sample_recognize_id_documents_async.py][sample_recognize_id_documents_async]
 * Recognize content: [sample_recognize_content_async.py][sample_recognize_content_async]
 * Recognize custom forms: [sample_recognize_custom_forms_async.py][sample_recognize_custom_forms_async]
 * Train a model without labels: [sample_train_model_without_labels_async.py][sample_train_model_without_labels_async]

sdk/formrecognizer/azure-ai-formrecognizer/samples/README.md

@@ -25,7 +25,7 @@ All of these samples need the endpoint to your Form Recognizer resource ([instru
 |[sample_recognize_receipts.py][sample_recognize_receipts] and [sample_recognize_receipts_async.py][sample_recognize_receipts_async]|Recognize data from a file of a sales receipt using a prebuilt model|
 |[sample_recognize_receipts_from_url.py][sample_recognize_receipts_from_url] and [sample_recognize_receipts_from_url_async.py][sample_recognize_receipts_from_url_async]|Recognize data from a URL of a sales receipt using a prebuilt model|
 |[sample_recognize_business_cards.py][sample_recognize_business_cards] and [sample_recognize_business_cards_async.py][sample_recognize_business_cards_async]|Recognize data from a file of a business card using a prebuilt model|
-|[sample_recognize_id_documents.py][sample_recognize_id_documents] and [sample_recognize_id_documents_async.py][sample_recognize_id_documents_async]|Recognize data from a file of an id document using a prebuilt model|
+|[sample_recognize_id_documents.py][sample_recognize_id_documents] and [sample_recognize_id_documents_async.py][sample_recognize_id_documents_async]|Recognize data from a file of an ID document using a prebuilt model|
 |[sample_recognize_invoices.py][sample_recognize_invoices] and [sample_recognize_invoices_async.py][sample_recognize_invoices_async]|Recognize data from a file of an invoice using a prebuilt model|
 |[sample_recognize_custom_forms.py][sample_recognize_custom_forms] and [sample_recognize_custom_forms_async.py][sample_recognize_custom_forms_async]|Recognize forms with your custom model|
 |[sample_train_model_without_labels.py][sample_train_model_without_labels] and [sample_train_model_without_labels_async.py][sample_train_model_without_labels_async]|Train a custom model with unlabeled data|