NLP engine sample + refresh on samples (#1388)

docs/analyzer/index.md

@@ -84,4 +84,4 @@ Follow the [API Spec](https://microsoft.github.io/presidio/api-docs/api-docs.htm
 
 ## Samples
 
-Samples illustrating the usage of the Presidio Analyzer can be found in the [Python samples](../samples/).
+Samples illustrating the usage of the Presidio Analyzer can be found in the [Python samples](../samples/index.md).

docs/requirements-docs.txt

@@ -1,6 +1,6 @@
 mkdocs
 mkdocs-material
-mknotebooks
+mkdocs-jupyter
 pymdown-extensions
 markdown
 mkdocstrings-python

docs/samples/index.md

@@ -2,32 +2,33 @@
 
 | Topic       |     Data Type     |Resource                                  | Sample                                                                                                                                          |
 | :---------- |:--------------------------------------| :---------------------------------| :---------------------------------------------------------------------------------------------------------------------------------------------- |
-| Usage | Text      | Python Notebook                       | [Presidio Basic Usage Notebook](https://github.com/microsoft/presidio/blob/main/docs/samples//python/presidio_notebook.ipynb)  |
-| Usage | Text       | Python Notebook                       | [Customizing Presidio Analyzer](https://github.com/microsoft/presidio/blob/main/docs/samples//python/customizing_presidio_analyzer.ipynb) |
-| Usage | Semi-structured       | Python Notebook                       | [Analyzing structured / semi-structured data in batch](https://github.com/microsoft/presidio/blob/main/docs/samples//python/batch_processing.ipynb)|
+| Usage | Text      | Python Notebook                        | [Presidio Basic Usage Notebook](python/presidio_notebook.ipynb)  |
+| Usage | Text       | Python Notebook                       | [Customizing Presidio Analyzer](python/customizing_presidio_analyzer.ipynb) |
+| Usage | Text       | Python Notebook                       | [Configuring The NLP engine](python/ner_model_configuration.ipynb) |
+| Usage | Semi-structured       | Python Notebook            | [Analyzing structured / semi-structured data in batch](https://github.com/microsoft/presidio/blob/main/docs/samples/python/batch_processing.ipynb)|
 | Usage | Text       | Python Notebook                       | [Encrypting and Decrypting identified entities](https://github.com/microsoft/presidio/blob/main/docs/samples//python/encrypt_decrypt.ipynb)|
 | Usage | Text       | Python Notebook                       | [Getting the identified entity value using a custom Operator](https://github.com/microsoft/presidio/blob/main/docs/samples/python/getting_entity_values.ipynb)|
 | Usage | text       | Python Notebook                       | [Anonymizing known values](https://github.com/microsoft/presidio/blob/main/docs/samples/python/Anonymizing%20known%20values.ipynb)
-| Usage | Images       | Python Notebook                       | [Redacting Text PII from DICOM images](python/example_dicom_image_redactor.ipynb)
-| Usage | Images        | Python Notebook                       | [Using an allow list with image redaction](https://github.com/microsoft/presidio/blob/main/docs/samples/python/image_redaction_allow_list_approach.ipynb)
-| Usage | PDF   | Python Notebook                       | [Annotating PII in a PDF](https://github.com/microsoft/presidio/blob/main/docs/samples/python/example_pdf_annotation.ipynb)
+| Usage | Images       | Python Notebook                     | [Redacting Text PII from DICOM images](python/example_dicom_image_redactor.ipynb)
+| Usage | Images        | Python Notebook                    | [Using an allow list with image redaction](https://github.com/microsoft/presidio/blob/main/docs/samples/python/image_redaction_allow_list_approach.ipynb)
+| Usage | PDF   | Python Notebook                            | [Annotating PII in a PDF](https://github.com/microsoft/presidio/blob/main/docs/samples/python/example_pdf_annotation.ipynb)
 | Usage | Images     | Python Notebook                       | [Plot custom bounding boxes](https://github.com/microsoft/presidio/blob/main/docs/samples/python/plot_custom_bboxes.ipynb)
-| Usage | Text     | Python Notebook                       | [Integrating with external services](https://github.com/microsoft/presidio/blob/main/docs/samples/python/integrating_with_external_services.ipynb) |
-| Usage | Text       | Python file                               | [Remote Recognizer](https://github.com/microsoft/presidio/blob/main/docs/samples/python/example_remote_recognizer.py) |
-| Usage | Structured     | Python Notebook                       | [Presidio Structured Basic Usage Notebook](https://github.com/microsoft/presidio/blob/main/docs/samples/python/example_structured.ipynb) |
-| Usage | Text      | Python file                               | [Azure AI Language as a Remote Recognizer](python/text_analytics/index.md)  |
-| Usage | CSV       | Python file                               | [Analyze and Anonymize CSV file](https://github.com/microsoft/presidio/blob/main/docs/samples/python/process_csv_file.py) |
-| Usage | Text      | Python                                | [Using Flair as an external PII model](https://github.com/microsoft/presidio/blob/main/docs/samples/python/flair_recognizer.py)|
-| Usage | Text      | Python file                               | [Using Span Marker as an external PII model](https://github.com/microsoft/presidio/blob/main/docs/samples/python/span_marker_recognizer.py)|
-| Usage | Text      | Python file                               | [Using Transformers as an external PII model](python/transformers_recognizer/index.md)|
-| Usage | Text      | Python file                               | [Pseudonomization (replace PII values using mappings)](https://github.com/microsoft/presidio/blob/main/docs/samples/python/pseudonomyzation.ipynb)|
-| Usage | Text      | Python file                               | [Passing a lambda as a Presidio anonymizer using Faker](https://github.com/microsoft/presidio/blob/main/docs/samples/python/example_custom_lambda_anonymizer.py)|
-| Usage      | | REST API (postman)                    | [Presidio as a REST endpoint](docker/index.md)|
-| Deployment | | App Service                           | [Presidio with App Service](deployments/app-service/index.md)|
-| Deployment | | Kubernetes                            | [Presidio with Kubernetes](deployments/k8s/index.md)|
-| Deployment | | Spark/Azure Databricks                | [Presidio with Spark](deployments/spark/index.md)|
-| Deployment | | Azure Data Factory with App Service   | [ETL for small dataset](deployments/data-factory/presidio-data-factory.md#option-1-presidio-as-an-http-rest-endpoint) |
-| Deployment | | Azure Data Factory with Databricks    | [ETL for large datasets](deployments/data-factory/presidio-data-factory.md#option-2-presidio-on-azure-databricks) |
+| Usage | Text     | Python Notebook                         | [Integrating with external services](https://github.com/microsoft/presidio/blob/main/docs/samples/python/integrating_with_external_services.ipynb) |
+| Usage | Text       | Python file                           | [Remote Recognizer](https://github.com/microsoft/presidio/blob/main/docs/samples/python/example_remote_recognizer.py) |
+| Usage | Structured     | Python Notebook                   | [Presidio Structured Basic Usage Notebook](https://github.com/microsoft/presidio/blob/main/docs/samples/python/example_structured.ipynb) |
+| Usage | Text      | Python file                            | [Azure AI Language as a Remote Recognizer](python/text_analytics/index.md)  |
+| Usage | CSV       | Python file                            | [Analyze and Anonymize CSV file](https://github.com/microsoft/presidio/blob/main/docs/samples/python/process_csv_file.py) |
+| Usage | Text      | Python                                 | [Using Flair as an external PII model](https://github.com/microsoft/presidio/blob/main/docs/samples/python/flair_recognizer.py)|
+| Usage | Text      | Python file                            | [Using Span Marker as an external PII model](https://github.com/microsoft/presidio/blob/main/docs/samples/python/span_marker_recognizer.py)|
+| Usage | Text      | Python file                            | [Using Transformers as an external PII model](python/transformers_recognizer/index.md)|
+| Usage | Text      | Python file                            | [Pseudonomization (replace PII values using mappings)](https://github.com/microsoft/presidio/blob/main/docs/samples/python/pseudonomyzation.ipynb)|
+| Usage | Text      | Python file                            | [Passing a lambda as a Presidio anonymizer using Faker](https://github.com/microsoft/presidio/blob/main/docs/samples/python/example_custom_lambda_anonymizer.py)|
+| Usage      | | REST API (postman)                          | [Presidio as a REST endpoint](docker/index.md)|
+| Deployment | | App Service                                 | [Presidio with App Service](deployments/app-service/index.md)|
+| Deployment | | Kubernetes                                  | [Presidio with Kubernetes](deployments/k8s/index.md)|
+| Deployment | | Spark/Azure Databricks                      | [Presidio with Spark](deployments/spark/index.md)|
+| Deployment | | Azure Data Factory with App Service         | [ETL for small dataset](deployments/data-factory/presidio-data-factory.md#option-1-presidio-as-an-http-rest-endpoint) |
+| Deployment | | Azure Data Factory with Databricks          | [ETL for large datasets](deployments/data-factory/presidio-data-factory.md#option-2-presidio-on-azure-databricks) |
 | ADF Pipeline | | Azure Data Factory | [Add Presidio as an HTTP service to your Azure Data Factory](deployments/data-factory/presidio-data-factory-template-gallery-http.md) |
 | ADF Pipeline | | Azure Data Factory | [Add Presidio on Databricks to your Azure Data Factory](deployments/data-factory/presidio-data-factory-template-gallery-databricks.md) |
 | Demo |  | Streamlit app | [Create a simple demo app using Streamlit](python/streamlit/index.md)

docs/samples/python/Anonymizing known values.ipynb

@@ -20,7 +20,7 @@
    "id": "3345f1c4",
    "metadata": {},
    "source": [
-    "Path to notebook: [https://www.github.com/microsoft/presidio/blob/main/docs/samples/python/Anonymizing%20known%20values.ipynb](https://www.github.com/microsoft/presidio/blob/main/docs/samples/python/Anonymizing%20known%20values.ipynb)"
+    "###### Path to notebook: [https://www.github.com/microsoft/presidio/blob/main/docs/samples/python/Anonymizing%20known%20values.ipynb](https://www.github.com/microsoft/presidio/blob/main/docs/samples/python/Anonymizing%20known%20values.ipynb)"
    ]
   },
   {

docs/samples/python/GPT3_synth_data.ipynb

@@ -21,7 +21,7 @@
             "id": "3345f1c4",
             "metadata": {},
             "source": [
-                "Path to notebook: [https://www.github.com/microsoft/presidio/blob/main/docs/samples/python/GPT3_synth_data.ipynb](https://www.github.com/microsoft/presidio/blob/main/docs/samples/python/GPT3_synth_data.ipynb)"
+                "###### Path to notebook: [https://www.github.com/microsoft/presidio/blob/main/docs/samples/python/GPT3_synth_data.ipynb](https://www.github.com/microsoft/presidio/blob/main/docs/samples/python/GPT3_synth_data.ipynb)"
             ]
         },
         {