Create diagnosticsource-getting-started.md

[mikelle-rogers]

Fixes #49082 and fixes #3029

[tommcdon]

LGTM thanks!

[gewarren]

Some general guidance that explains a lot of my comments:

• Okay to use "you" but not "we" or "our".
• Shorten sentences to help with localization.
• Use active voice over passive.

[josalem]

In general, I think we should consolidate the code samples into all-inclusive samples and then break down their contents. Users will want to be able to visit this guide and leave with a snippet of code they can build on. Having everything broken up makes that a complex task of grokking the whole page.

[gewarren]

In general, I think we should consolidate the code samples into all-inclusive samples and then break down their contents. Users will want to be able to visit this guide and leave with a snippet of code they can build on. Having everything broken up makes that a complex task of grokking the whole page.

The best way to accomplish that would be to put all the code into a *.cs file and check that in with a *.csproj file so we can verify that it compiles. And then add snippet tags (you can name them anything; the format is // <yoursnippettag> to start the snippet and // </yoursnippettag> to end it) around the different sections that you want to break out in the tutorial.

The docs markdown to reference a snippet looks like:

:::code language="csharp" source="snippets/character-encoding-introduction/csharp/PrintStringChars.cs" id="SnippetPrintChars":::

And you could have a note in the tutorial with a link to the *.cs file to see the entire example? Or, if you think it's useful as a code sample, you can check it into the dotnet/samples repo and then link to the sample.

[gewarren]

Can you change all the ```C# lines to ```csharp?
And for all the output code, they should be labeled as console.

[gewarren]

Please also add the file to the table of contents (toc.yml). Sorry I didn't catch that earlier.

[mikelle-rogers]

@gewarren

Please also add the file to the table of contents (toc.yml). Sorry I didn't catch that earlier.

Only this file, or the entire diagnostics repo? Is this the toc.yml file you mentioned? https://github.com/dotnet/docs/blob/dev/mirogers/diagnosticsource-getting-started/docs/toc.yml

[gewarren]

@gewarren

Please also add the file to the table of contents (toc.yml). Sorry I didn't catch that earlier.

Only this file, or the entire diagnostics repo? Is this the toc.yml file you mentioned? https://github.com/dotnet/docs/blob/dev/mirogers/diagnosticsource-getting-started/docs/toc.yml

Just this file, since it's new. The TOC file is at https://github.com/dotnet/docs/blob/main/docs/fundamentals/toc.yml.