Show how implement conditional methods in C#.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

Show how to implement a class that uses indexed properties.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

Should teach the basics of declaring and using properties in C#.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

Was looking at the TOC at RTD: http://dotnet.readthedocs.org/en/latest/index.html.

I'm wondering if we want to re-think the TOC. It feels a little too fine-grained at the top and not quite thematic enough. I'm thinking (out loud) that we could adopt these approaches:

• Outcome based (build a lib, build an app, build an analyzer).
• Component based (Runtime, BCL, Roslyn)
• Experience based (Developing with VS, Developing on Linux)
• Difficulty based (Getting started, Advanced topics)

I'm sure that there are more of these. Right now, we've got a combination of these. I'm not advocating some purist approach, just that we should decide what our primary approach is for the TOC and bias more towards that.

I'm writing a new doc #46. It wasn't clear to me where that should go in the TOC or if it even appropriate for it to be a doc by itself. Thematically, it is more "outcome based". That isn't to suggest that we should go with outcome based as our plan.

/cc @blackdwarf, @cartermp

dnx . run results in an error message

We need VB.NET LINQ in the tutorials list. This is a big topic so there could be a lot of samples here. Good starting point: https://code.msdn.microsoft.com/101-LINQ-Samples-3fb9811b

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

Shows how to declare, invoke, and hook up to events in C#.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

There is a broken link to the Sphinx Style Guide within the contributing.md that should be fixed.

Currently renders as
Sphinx Style Guide

Should be
Sphinx Style Guide

Just wondering, what are the plans for BCL API reference? (available at http://dotnet.readthedocs.org/en/latest/bcl/api-ref.html )

Generated by an external tool?
How does it integrate in Sphinx workflow?
What tool/work would be necessary?

Should teach versioning in C# through the use of the override and new keywords.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

Show how to document code using XML doc comments.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

Add more examples to the linq restriction operator samples

Same as #44 update the usage examples with the latest runtime and remove the '.' from the dnx run usage.

Update docs/getting-started/installing-core-windows.rst with latest versions and fix typo

I would like to contribute to this project and was wondering if I need to open an issue to start working on an existing topic\stub. For example, I would like to start working on https://github.com/dotnet/core-docs/blob/master/docs/development/using-visual-studio-code.rst.

Do I open a new issue or just start working and submit a new pull request?

Thanks!

We should update the installing-core-linux document with the latest versions of the runtime or make it version agnostic like currently shown on http://dotnet.github.io/core/getting-started/. Also found a typo in the instructions on running the app.

Closed these two PRs in prep for that.

dotnet/coreclr#407
dotnet/coreclr#725

SHow how to use expression trees to enable dynamic modification of executable code in C#.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

Shows how to implement binary, XML, and SOAP serialization in C#.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

Show how to explicitly implement interface members and how to access those members from the interface instances.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

Should teach the basic concepts of creating and using arrays in C#.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

This is for library creators and includes creating NuGet packages. It includes new packages and existing ones that also want to target .NET Core. It's basically the document that explains how to target the combination of .NET Core and NuGet v3 (3.3+). We need to explain how this relates to NuGet v2.

We should start with building class libraries and then explain how to package them. That's basically the two major sections of the doc.

We bias the document towards people who are already using PCL, since it targets the same problem space. This will allow us to get something out the door more quickly.

We should make this scenario-based:

• I support a small set of platforms, such as .NET Framework 4.5.1+ and .NET Core. What do I do?
• I support every .NET platform ever shipped. What do I do?

To start of, this is for folks using the myget feed. It lands as "stable" in RC1.

Library questions:

• Can I use PCL to target .NET Core?
• What's the difference between PCL and dotnet targeting?
• How can I target .NET Core and other platforms including PCL?
• How do I target specific platforms (I want it to run on Windows Phone, Xamarin iOS and Linux for ASP.NET).
• Which generation do I use?
• Which project type do I use?

Package questions:

• Can I use PCL to target .NET Core? Add "+dotnet"?
• What do I put as dependencies of my package?

Under Tutorials & Samples the following item should be listed:

• Writing your first UWP app

• The opening paragraph seems very vague. If I'm a newbie or non-developer and somehow land on this topic, what do I use the .NET platform and these standards for?

.NET Core section

• You introduce the list of characteristics like this "There are several characteristics of .NET Core:", but you're actually listing the main ones. Maybe it'd be good to be more specific.
• I'd use a more common word than boon. Maybe advantage or gain?
• The list of characteristics doesn't look uniform. Some are written as paragraphs, some as list items. It'd be good to have a consistent behavior.
• For cross-platform support, is it really about running on the best environment? Or is it about the different environment offerings we have out there?
• For open source: Should we also mention the transparency aspect of open source? Or having the community helping shape the future of .NET Core? The description seems really minimal.
• For application isolation, instead of "take" wouldn't be better to say embed?

.NET Framework

• It should be .NET Framework Class Library not Framework Class Libraries. Also, should it link to the library on MSDN?
• I would avoid using the apostrophe (') there to show possession. So instead of "Windows Forms' strength" I'd say "The strength of Windows Forms" and for the second one, I'd just remove the apostrophe.
• "that is suited for your use case" or "that is best suited for your use case"?
• I don't get what MVC does based on the description. Should we talk about patterns or separation of concerns here? The link you point to has a good brief description

.NET native

• fix punctuation here: (such as C#, Visual Basic, F# etc.)
• put (IL) after "Intermediate Language"
• Maybe this sentence: "IL is then picked up by the runtime, and Just-In-Time compiled at run-time to machine code." could be better explained as "At run-time, a just-in-time (JIT) compiler translates the IL into native code" (or machine code)
• .NET Native NET Native - remove duplication
• Should we link to https://msdn.microsoft.com/en-us/library/windows/apps/dn726767.aspx, where you mention UWP apps?

Currently the primer has a link to a document that isn't in the TOC tree describing briefly what the FCL is, giving a brief overview of the BCL and some examples of what the BCL and FCL contain.

There is also a section called "Base Class Library", which I think is a good candidate for renaming to "Framework Class Library" and modifying it to contain all things FCL, including a link to reference documentation. This would include:

• Overview of the FCL with a diagram showing its relationship with .NET Managed Langs
  • Section with BCL overview and example of its contents, with link to reference docs
  • Section with other FCL examples, with links to reference docs
• Article about FCL libraries which are important for cloud devs
  • Snippet about each relevant library for cloud devs with sample code highlighting a common use case in C#, VB, and F#
  • Link to reference docs for each library
  • Links to sample applications or full code samples
• Article about FCL libraries which are important for mobile devs
  • same as for the cloud devs article
  • Links to the UWP samples and other platform samples

I see value in making it clear to developers the relationship between the libraries and the languages and providing conceptual docs + code samples covering some common scenarios. This is a large enough area that it also demands its own section.

dnx . run results in an error message

dnx . run results in an error message

Create a basic Hello World tutorial for developers new to C#.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

Show how to use iterators in c# to step through collections and return elements one at a time.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

I'm trying to follow csharp-semantic.pdf under docs/samples. When I add this code:

var compilation = CSharpCompilation.Create("HelloWorld")
 .AddReferences(
   new MetadataFileReference(typeof(object).Assembly.Location))
 .AddSyntaxTrees(tree);

I get a compilation error because MetadataFileReference is an internal type.

Show how to enable implicit conversion of generic type parameters in interfaces and delegates in C#.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

Add samples that demonstrate aggregating data

Shows how to map delegates to static and instance methods, and how to combine them (multicast).

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

Should cover creating and working with collections in C#.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

Show how to implement asynchronous operations in C# using async and await.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

Update the version of System.Console from 4.0.0-RC1* to 4.0.0-Beta*

Show how user-defined classes can overload operators.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

I feel like there should be a separate section dedicated to async programming. Especially if we're going to be targeting cloud and devices devs, it's paramount to get it across that .NET can handle potentially complicated async code with simple language constructs and a super nice programming model.

Show how to use reflection to dynamically create an instance of a type, bind the type to an existing object, or get the type from an existing object and invoke its methods or access its fields and properties.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

Show how C# classes can declare indexers to provide array-like access to the classes.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

We need LINQ in the tutorials list. This is a big topic so there could be a lot of samples here. Good starting point: https://code.msdn.microsoft.com/101-LINQ-Samples-3fb9811b

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

[BillWagner] Adding sub-tasks:

• Bring forward the LINQ overview from the .NET Primer.
• Provide an overview of LINQ and databases, with extensive links to the EF documentation
• Provide a reference to Azure Storage LINQ providers.
• Bring forward explanations from the 101 LINQ samples (code has been added, descriptions have not).

Show how to do multi-threading in C#.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

Show how to define and use conversions to or from classes or structs.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

We need to add the structure for the sample code so that people can start adding compilable sample code.

Here is the terminal output when I try to add the key from the server:

Executing: gpg --ignore-time-conflict --no-options --no-default-keyring --homedir /tmp/tmp.Hrb5ETPac2 --no-auto-check-trustdb --trust-model always --keyring /etc/apt/trusted.gpg --primary-keyring /etc/apt/trusted.gpg --keyserver keyserver.ubuntu.com --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
gpg: requesting key D3D831EF from hkp server keyserver.ubuntu.com
gpg: keyserver timed out
gpg: keyserver receive failed: keyserver error

I tried several times but always give me an error. I precise that I'm using the ubuntu official image in a Docker container.
Regards

Shows how to connect to services and work with them in C#.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

I think adding a piece from the CoreFx Interop source in the .NET Primer would look great because it showcases unsafe succinctly and also shows that you can get "down to the metal" without having to switch languages.

Should cover the syntax and usage of structs in C#, including the differences between structs and classes. Should provide guidance on when to use structs over classes (and vice/versa).

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

Show how to provide additional information about programming elements such as types, fields, methods, and properties by using attributes.

Tutorials should include one or more code examples, each example should also show expected output and should include an explanation of the code where it isn't obvious. Examples shouldn't be dependent on a specific IDE or target platform.

As the .NET Primer alludes to, there should be a more in-depth LINQ article.

LINQ article would cover:

• Small blurb about what it is and why it's a thing
• What are IEnumerable and IQueryable and what are they used for
• Samples which highlight what's used the most
• Link to the 101 LINQ Samples
• Explanation of when to use the query syntax vs the API syntax
• Some more in-depth stuff someone should know when getting started (like deferred execution)
• PLINQ blurb with example and link to more PLINQ