.NET Core
- Items
Managed Languages
- Items
.NET Core
- Clear old milestone and project issues
- WInForms planning
- Updates to .NET Core installer versions
Managed Languages
- Clear old milestone and project issues
- C# 8.0 content catchup
- C# specification work
Repo
- Migrate snippets from samples repo
The initial discussion is in #2840.
There are several related goals to this project:
- Minimize redundant information. Much of the language reference is duplicated in the spec. They have drifted over time.
- Put related features on the same page. That helps readers find alternatives to the syntax they were searching.
- Optimize for search on unfamiliar tokens. Readers search when they see unfamiliar syntax. We want them to quickly find what those tokens mean, and learn more quickly.
- Consolidate the amount of content.
This project will make those changes in several steps:
- Publish the language spec proposals for features released after C# 6.0 (draft spec available)
- Create a new "Abridged Language Reference" section that consolidates much of the existing content and refers readers interested in more details to one or more sections of the spec or proposals.
- For each sub-section in the "Abridged Language Reference" do the following:
- Create the new articles
- Search for existing issues on content being migrated and consolidated. This is a good opportunity to fix those.
- Redirect existing content to the new articles.
- Remove old articles.
- Update all links in the .NET Content
The sub-sections are:
- builtin types
- operators
- primary operators
- unary operators
- arithmetic operators
- relational and equality operators
- type testing and assignment
- logical operators
- other operators and special tokens
- Defining types, members and variables
- declaring types
- declaring members
- controlling access
- Statements
- selection and jump statements
- iteration statements
- exception statements
- other statements
- LINQ query expressions
- Conversions
- Attributes
- Unsafe code
- Documentation comments
- Compiler options
One section require more detail: The compiler error and warning messages. This is covered in https://github.com/dotnet/docs/projects/44 There are three main changes for that section:
- Remove entries from the TOC. These articles should be found via search for specific error codes or messages.
- Put all content in the same folder (they are currently in two locations)
- Add missing warnings and errors (most starting with Version 6)
This project lists issues:
- That are potential candidates for the vendor team. This can help us assess whether a group of issues have reached a critical mass that makes it worthwhile for the vendor team to handle them.
- That are currently being handled by the vendor team.
- That have been completed by the vendor team.
The nullable reference type additions to the language will have impact on existing codebases.
This content will provide readers with the background needed to evaluate the new feature on their existing codebases when the public previews for the feature are released.
Those interested in exploring can learn about the feature and explore its uses.