As .NET 5 Nears, Content/Documentation Reorganization Starts

A GitHub project is seeking to reorganize documentation and developer content in advance of the November debut of .NET 5, a unification of all things .NET that combines. .NET Core and other components.

"There will be just one .NET going forward, and you will be able to use it to target Windows, Linux, macOS, iOS, Android, tvOS, watchOS and WebAssembly and more," Microsoft said last year in announcing .NET 5, which will include desktop components, web, cloud, mobile, gaming, IoT and AI.

Along with that huge consolidation effort, a GitHub issue titled ".NET 5 Wave - Reorganization #18923" is seeking to change the way users and developers find content, such as documentation.

"For .NET 5, we are reorganizing the content to match the workloads describing what you can build with .NET. Each child project contains the issues (tasks) for that specific workload area," says the issue opened by Microsoft's David Pine. "The amount of work reflects the organization of content that no longer reflects the modern .NET vision. Visitors should not need to understand the history of .NET to find information to build .NET apps now.

"However, existing customers should be able to easily find content based on their current knowledge of the product and its brand names."

.NET 5
[Click on image for larger view.] .NET 5 (source: Microsoft).

Areas being targeted include ".NET Framework (.NET 5 Wave)," the legacy offering before .NET Core took .NET cross-platform and open source. It will require little new content, mainly involving moving existing content.

By contrast, ".NET Fundamentals (.NET 5 wave)" will require the most reorganization. "The docs we have now are organized around 'Framework', 'Core', and '.NET Standard'. Navigation requires understanding the history. That's a barrier for new .NET developers. The new organization reflects the 'One .NET' vision of .NET 5 / .NET 6," that item states.

Other areas of reorganization run the gamut from web to mobile to data to cloud to machine learning.

The .NET 5 Wave Project
[Click on image for larger view.] The .NET 5 Wave Project (source: Microsoft).

One reader in a comment asked if the .NET Web and .NET Mobile areas will see existing ASP.NET and Xamarin documentation get merged in.

"Yes and no, and on different schedules," was the reply from Bill Wagner. "I'll defer to the respective issues and projects for a detailed discussion. Here's a brief version:

"In both cases, these docsets will appear under the docset. The ASP.NET Core docs will be published under Some xamarin docs will be published under

"However, we're not moving the source or closing those repositories. Instead, we'll update build scripts to chagne the active URL. We will keep history and the repository organization."

About the Author

David Ramel is an editor and writer for Converge360.

comments powered by Disqus


  • C# Slides in Usage Ranking of Programming Languages

    "The fact that C# lost three places in the ranking of language communities during the last three years is mostly explained by its slower growth compared to C/C++ and PHP."

  • Telerik UI for Blazor Updated

    Progress announced an update to its Telerik UI for Blazor components, targeting Microsoft's open source Blazor framework that lets C# coders create web apps without having to rely upon JavaScript.

  • Infragistics Unveils UI Components for Blazor

    Infragistics, specializing in third-party UI/UX controls and tools, unveiled a new offering targeting Blazor, Microsoft's red-hot open source framework that allows for C#-based web development instead of traditional mainstay JavaScript.

  • AWS Open Sources Tool for Porting .NET Framework Apps to .NET Core

    Leading cloud computing platform Amazon Web Services open sourced the it announced in July for helping users port old .NET Framework applications to the new .NET Core framework.

  • Uno Platform Ports Windows Calculator to Linux

    Uno Platform has ported the famed Windows Calculator, open sourced last year, to Linux as part of a continuing "proof point" effort to demonstrate the reach of what it describes as the sole UI offering available to target Windows, WebAssembly, iOS, macOS, Android and Linux with single-codebase applications coded in C# and XAML.

Upcoming Events