Azure / autorest.csharp

Extension for AutoRest (https://github.com/Azure/autorest) that generates C# code
MIT License
142 stars 166 forks source link

Document improvement #354

Open formulahendry opened 4 years ago

formulahendry commented 4 years ago

1

The Project Setup says that the C# code generated by C# can be included in multiple Visual Studio project types: https://github.com/Azure/autorest/blob/master/docs/client/proj-setup.md#project-setup

I could also run it in .NET Core 3.0, I think this part could be updated.

2

In the docs, it is targeting Visual Studio project https://github.com/Azure/autorest/blob/master/docs/client/proj-setup.md#add-generated-files-to-the-project. However, for IoT developers, some of them are using VS Code or other IDE/Editors. It would be great the docs could also have some instruction for VS Code, CLI, or other IDE/Editors, not only for VS IDE.

MiYanni commented 4 years ago

@fearthecowboy Hey bud. The 2 links pointed to in the issue description seem very, very old. Any reason docs like this (still) exist in the autorest repo? We could shove them into CSharp V2 branch here (master).

fearthecowboy commented 4 years ago

We haven't done a good doc scrub at all.

Probably what we should do is figure out a clear way of bringing docs together. Perhaps a site that pulls in per-language docs from those repos.