Azure-docs: the tutorial and code sample should be updated to avoid errors and confusion.

[mouadcherkaoui]

Hi,

I started with the problems in this thread on msdn: https://social.msdn.microsoft.com/Forums/en-US/57296376-86c7-46af-9004-6d8cc5c6906c/i-am-trying-to-use-sample-code-on-microsoft-documents-for-form-recognizer-but-it-has-so-many-errors?forum=Offtopic

in the beginning, I suspected that it was just a missing package, but when I started I found that the organization is confusing, also there is no explicit instruction that informs the learner that he must install Azure.Ai.FormRecognizer, at certain parts the parameters passed to the methods needs to be converted for example from Guid to string, I'll work on it today and give you more details about the errors and how to resolve them.

[Enter feedback here]

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 1e3de1b4-a118-efae-0e72-7953c8e891b3
• Version Independent ID: 5ad38c9e-c775-8dbc-16ff-705a40b580e1
• Content: Quickstart: Form Recognizer client library - Azure Cognitive Services
• Content Source: articles/cognitive-services/form-recognizer/quickstarts/client-library.md
• Service: cognitive-services
• Sub-service: forms-recognizer
• GitHub Login: @PatrickFarley
• Microsoft Alias: pafarley

[GiftA-MSFT]

@mouadcherkaoui we'll review your feedback and get back to you shortly. Thanks.

[mouadcherkaoui]

thank you,
here is a version that builds correctly, but didn't test it yet at runtime:
https://github.com/mouadcherkaoui/AzureAIFormRecognizer

for example here:

https://github.com/mouadcherkaoui/AzureAIFormRecognizer/blob/master/Program.cs#L169
https://github.com/mouadcherkaoui/AzureAIFormRecognizer/blob/master/Program.cs#L196
https://github.com/mouadcherkaoui/AzureAIFormRecognizer/blob/master/Program.cs#L249

I found that the first argument in the sample is of FormRecognizerClient, but the methods are those of FormTrainingClient, I'll try to test execution and to add comments to the other parts.

Best regards.
Thank you!

[GiftA-MSFT]

@mouadcherkaoui the document does provide instructions for installing the client library.

[mouadcherkaoui]

Ok! then the right version is the preview.3!
perfect,
Thank you!