[formrecognizer] Rename samples directory (Azure#30303)

* rename samples folder

* update sample readme link

* update sample refs

* update readme

* update comments

Author: catalinaperalta

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

@@ -765,7 +765,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct][code_of_con
 [sample_readme]: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/formrecognizer/azure-ai-formrecognizer/samples
 [changelog]: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/formrecognizer/azure-ai-formrecognizer/CHANGELOG.md
 [migration-guide]: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/formrecognizer/azure-ai-formrecognizer/MIGRATION_GUIDE.md
-[classify_sample]: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/formrecognizer/azure-ai-formrecognizer/samples/v3.2/sample_classify_document.py
+[classify_sample]: https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/formrecognizer/azure-ai-formrecognizer/samples/v3.2_and_later/sample_classify_document.py
 
 [cla]: https://cla.microsoft.com
 [code_of_conduct]: https://opensource.microsoft.com/codeofconduct/

sdk/formrecognizer/azure-ai-formrecognizer/azure/ai/formrecognizer/_document_analysis_client.py

@@ -43,14 +43,14 @@ class DocumentAnalysisClient(FormRecognizerClientBase):
 
     .. admonition:: Example:
 
-        .. literalinclude:: ../samples/v3.2/sample_authentication.py
+        .. literalinclude:: ../samples/v3.2_and_later/sample_authentication.py
             :start-after: [START create_da_client_with_key]
             :end-before: [END create_da_client_with_key]
             :language: python
             :dedent: 4
             :caption: Creating the DocumentAnalysisClient with an endpoint and API key.
 
-        .. literalinclude:: ../samples/v3.2/sample_authentication.py
+        .. literalinclude:: ../samples/v3.2_and_later/sample_authentication.py
             :start-after: [START create_da_client_with_aad]
             :end-before: [END create_da_client_with_aad]
             :language: python
@@ -100,14 +100,14 @@ def begin_analyze_document(
 
         .. admonition:: Example:
 
-            .. literalinclude:: ../samples/v3.2/sample_analyze_invoices.py
+            .. literalinclude:: ../samples/v3.2_and_later/sample_analyze_invoices.py
                 :start-after: [START analyze_invoices]
                 :end-before: [END analyze_invoices]
                 :language: python
                 :dedent: 4
                 :caption: Analyze an invoice. For more samples see the `samples` folder.
 
-            .. literalinclude:: ../samples/v3.2/sample_analyze_custom_documents.py
+            .. literalinclude:: ../samples/v3.2_and_later/sample_analyze_custom_documents.py
                 :start-after: [START analyze_custom_documents]
                 :end-before: [END analyze_custom_documents]
                 :language: python
@@ -176,7 +176,7 @@ def begin_analyze_document_from_url(
 
         .. admonition:: Example:
 
-            .. literalinclude:: ../samples/v3.2/sample_analyze_receipts_from_url.py
+            .. literalinclude:: ../samples/v3.2_and_later/sample_analyze_receipts_from_url.py
                 :start-after: [START analyze_receipts_from_url]
                 :end-before: [END analyze_receipts_from_url]
                 :language: python
@@ -239,7 +239,7 @@ def begin_classify_document(
 
         .. admonition:: Example:
 
-            .. literalinclude:: ../samples/v3.2/sample_classify_document.py
+            .. literalinclude:: ../samples/v3.2_and_later/sample_classify_document.py
                 :start-after: [START classify_document]
                 :end-before: [END classify_document]
                 :language: python
@@ -289,7 +289,7 @@ def begin_classify_document_from_url(
 
         .. admonition:: Example:
 
-            .. literalinclude:: ../samples/v3.2/sample_classify_document_from_url.py
+            .. literalinclude:: ../samples/v3.2_and_later/sample_classify_document_from_url.py
                 :start-after: [START classify_document_from_url]
                 :end-before: [END classify_document_from_url]
                 :language: python

sdk/formrecognizer/azure-ai-formrecognizer/azure/ai/formrecognizer/_document_model_administration_client.py

@@ -69,14 +69,14 @@ class DocumentModelAdministrationClient(FormRecognizerClientBase):
 
     .. admonition:: Example:
 
-        .. literalinclude:: ../samples/v3.2/sample_authentication.py
+        .. literalinclude:: ../samples/v3.2_and_later/sample_authentication.py
             :start-after: [START create_dt_client_with_key]
             :end-before: [END create_dt_client_with_key]
             :language: python
             :dedent: 4
             :caption: Creating the DocumentModelAdministrationClient with an endpoint and API key.
 
-        .. literalinclude:: ../samples/v3.2/sample_authentication.py
+        .. literalinclude:: ../samples/v3.2_and_later/sample_authentication.py
             :start-after: [START create_dt_client_with_aad]
             :end-before: [END create_dt_client_with_aad]
             :language: python
@@ -158,7 +158,7 @@ def begin_build_document_model(
 
         .. admonition:: Example:
 
-            .. literalinclude:: ../samples/v3.2/sample_build_model.py
+            .. literalinclude:: ../samples/v3.2_and_later/sample_build_model.py
                 :start-after: [START build_model]
                 :end-before: [END build_model]
                 :language: python
@@ -250,7 +250,7 @@ def begin_compose_document_model(
 
         .. admonition:: Example:
 
-            .. literalinclude:: ../samples/v3.2/sample_compose_model.py
+            .. literalinclude:: ../samples/v3.2_and_later/sample_compose_model.py
                 :start-after: [START composed_model]
                 :end-before: [END composed_model]
                 :language: python
@@ -355,7 +355,7 @@ def begin_copy_document_model_to(
 
         .. admonition:: Example:
 
-            .. literalinclude:: ../samples/v3.2/sample_copy_model_to.py
+            .. literalinclude:: ../samples/v3.2_and_later/sample_copy_model_to.py
                 :start-after: [START begin_copy_document_model_to]
                 :end-before: [END begin_copy_document_model_to]
                 :language: python
@@ -409,7 +409,7 @@ def delete_document_model(self, model_id: str, **kwargs: Any) -> None:
 
         .. admonition:: Example:
 
-            .. literalinclude:: ../samples/v3.2/sample_manage_models.py
+            .. literalinclude:: ../samples/v3.2_and_later/sample_manage_models.py
                 :start-after: [START delete_document_model]
                 :end-before: [END delete_document_model]
                 :language: python
@@ -437,7 +437,7 @@ def list_document_models(self, **kwargs: Any) -> ItemPaged[DocumentModelSummary]
 
         .. admonition:: Example:
 
-            .. literalinclude:: ../samples/v3.2/sample_manage_models.py
+            .. literalinclude:: ../samples/v3.2_and_later/sample_manage_models.py
                 :start-after: [START list_document_models]
                 :end-before: [END list_document_models]
                 :language: python
@@ -467,7 +467,7 @@ def get_resource_details(self, **kwargs: Any) -> ResourceDetails:
 
         .. admonition:: Example:
 
-            .. literalinclude:: ../samples/v3.2/sample_manage_models.py
+            .. literalinclude:: ../samples/v3.2_and_later/sample_manage_models.py
                 :start-after: [START get_resource_details]
                 :end-before: [END get_resource_details]
                 :language: python
@@ -493,7 +493,7 @@ def get_document_model(self, model_id: str, **kwargs: Any) -> DocumentModelDetai
 
         .. admonition:: Example:
 
-            .. literalinclude:: ../samples/v3.2/sample_manage_models.py
+            .. literalinclude:: ../samples/v3.2_and_later/sample_manage_models.py
                 :start-after: [START get_document_model]
                 :end-before: [END get_document_model]
                 :language: python
@@ -525,7 +525,7 @@ def list_operations(self, **kwargs: Any) -> ItemPaged[OperationSummary]:
 
         .. admonition:: Example:
 
-            .. literalinclude:: ../samples/v3.2/sample_get_operations.py
+            .. literalinclude:: ../samples/v3.2_and_later/sample_get_operations.py
                 :start-after: [START list_operations]
                 :end-before: [END list_operations]
                 :language: python
@@ -560,7 +560,7 @@ def get_operation(self, operation_id: str, **kwargs: Any) -> OperationDetails:
 
         .. admonition:: Example:
 
-            .. literalinclude:: ../samples/v3.2/sample_get_operations.py
+            .. literalinclude:: ../samples/v3.2_and_later/sample_get_operations.py
                 :start-after: [START get_operation]
                 :end-before: [END get_operation]
                 :language: python
@@ -606,7 +606,7 @@ def begin_build_document_classifier(
 
         .. admonition:: Example:
 
-            .. literalinclude:: ../samples/v3.2/sample_build_classifier.py
+            .. literalinclude:: ../samples/v3.2_and_later/sample_build_classifier.py
                 :start-after: [START build_classifier]
                 :end-before: [END build_classifier]
                 :language: python
@@ -656,7 +656,7 @@ def get_document_classifier(self, classifier_id: str, **kwargs: Any) -> Document
 
         .. admonition:: Example:
 
-            .. literalinclude:: ../samples/v3.2/sample_manage_classifiers.py
+            .. literalinclude:: ../samples/v3.2_and_later/sample_manage_classifiers.py
                 :start-after: [START get_document_classifier]
                 :end-before: [END get_document_classifier]
                 :language: python
@@ -687,7 +687,7 @@ def list_document_classifiers(self, **kwargs: Any) -> ItemPaged[DocumentClassifi
 
         .. admonition:: Example:
 
-            .. literalinclude:: ../samples/v3.2/sample_manage_classifiers.py
+            .. literalinclude:: ../samples/v3.2_and_later/sample_manage_classifiers.py
                 :start-after: [START list_document_classifiers]
                 :end-before: [END list_document_classifiers]
                 :language: python
@@ -719,7 +719,7 @@ def delete_document_classifier(self, classifier_id: str, **kwargs: Any) -> None:
 
         .. admonition:: Example:
 
-            .. literalinclude:: ../samples/v3.2/sample_manage_classifiers.py
+            .. literalinclude:: ../samples/v3.2_and_later/sample_manage_classifiers.py
                 :start-after: [START delete_document_classifier]
                 :end-before: [END delete_document_classifier]
                 :language: python

sdk/formrecognizer/azure-ai-formrecognizer/azure/ai/formrecognizer/aio/_document_analysis_client_async.py

@@ -44,14 +44,14 @@ class DocumentAnalysisClient(FormRecognizerClientBaseAsync):
 
     .. admonition:: Example:
 
-        .. literalinclude:: ../samples/v3.2/async_samples/sample_authentication_async.py
+        .. literalinclude:: ../samples/v3.2_and_later/async_samples/sample_authentication_async.py
             :start-after: [START create_da_client_with_key_async]
             :end-before: [END create_da_client_with_key_async]
             :language: python
             :dedent: 4
             :caption: Creating the DocumentAnalysisClient with an endpoint and API key.
 
-        .. literalinclude:: ../samples/v3.2/async_samples/sample_authentication_async.py
+        .. literalinclude:: ../samples/v3.2_and_later/async_samples/sample_authentication_async.py
             :start-after: [START create_da_client_with_aad_async]
             :end-before: [END create_da_client_with_aad_async]
             :language: python
@@ -103,14 +103,14 @@ async def begin_analyze_document(
 
         .. admonition:: Example:
 
-            .. literalinclude:: ../samples/v3.2/async_samples/sample_analyze_invoices_async.py
+            .. literalinclude:: ../samples/v3.2_and_later/async_samples/sample_analyze_invoices_async.py
                 :start-after: [START analyze_invoices_async]
                 :end-before: [END analyze_invoices_async]
                 :language: python
                 :dedent: 4
                 :caption: Analyze an invoice. For more samples see the `samples` folder.
 
-            .. literalinclude:: ../samples/v3.2/async_samples/sample_analyze_custom_documents_async.py
+            .. literalinclude:: ../samples/v3.2_and_later/async_samples/sample_analyze_custom_documents_async.py
                 :start-after: [START analyze_custom_documents_async]
                 :end-before: [END analyze_custom_documents_async]
                 :language: python
@@ -179,7 +179,7 @@ async def begin_analyze_document_from_url(
 
         .. admonition:: Example:
 
-            .. literalinclude:: ../samples/v3.2/async_samples/sample_analyze_receipts_from_url_async.py
+            .. literalinclude:: ../samples/v3.2_and_later/async_samples/sample_analyze_receipts_from_url_async.py
                 :start-after: [START analyze_receipts_from_url_async]
                 :end-before: [END analyze_receipts_from_url_async]
                 :language: python
@@ -242,7 +242,7 @@ async def begin_classify_document(
 
         .. admonition:: Example:
 
-            .. literalinclude:: ../samples/v3.2/async_samples/sample_classify_document_async.py
+            .. literalinclude:: ../samples/v3.2_and_later/async_samples/sample_classify_document_async.py
                 :start-after: [START classify_document_async]
                 :end-before: [END classify_document_async]
                 :language: python
@@ -292,7 +292,7 @@ async def begin_classify_document_from_url(
 
         .. admonition:: Example:
 
-            .. literalinclude:: ../samples/v3.2/async_samples/sample_classify_document_from_url_async.py
+            .. literalinclude:: ../samples/v3.2_and_later/async_samples/sample_classify_document_from_url_async.py
                 :start-after: [START classify_document_from_url_async]
                 :end-before: [END classify_document_from_url_async]
                 :language: python