Review and improve XML comments

[OlegRa]

The built-in C# XML documentation contains a lot of incorrect spelling, unclear wording, and other errors. Review XML documentation comments in code, fix typos, and improve clearness. I'm open to accepting pull requests with these fixes. Let's make SDK better for new users together!

[mohitsaxenaknoldus]

I am starting to work on this. Are you talking about these files?: https://github.com/alpacahq/alpaca-trade-api-csharp/tree/develop/Documentation
@OlegRa

[mohitsaxenaknoldus]

Hey @OlegRa I need some help finding these comments. I can't seem to find any XML comments in the Documentation directory.

[OlegRa]

@mohitsaxenaknoldus The Documentation directory contains the DocFX project that generates HTML files from the XML documentation files. The XML documentation in their turn generated from the C# source code (.cs files) by the C# compiler. So you have to review these .cs files, fix issues, build HTML files (use the Documentation solution configuration) and verify results.

[natehitze]

@OlegRa Is there more you want for this issue?

[OlegRa]

@natehitze First, thanks a lot for your work and your PR - it's really valuable and I hope it will make SDK usage in IDE simpler.

Second, I have some ideas about improving auto-generated documentation in general but these changes are mostly related to DocFx styling/content not to XML documentation. If you have some experience in this area and willingness to help - I can open a separate issue for discussing possible improvements.