Merge moniker docsets into a single docset #2065
Labels
dotnet-desktop/svc
dotnet-framework/svc
📌 seQUESTered
Label to indicate an item has been imported.
winforms/subsvc
wpf/subsvc
Right now we have the .NET Framework version of WPF and WinForms contained in one directory, and the .NET version in another. Redirects are filed between the projects to allow people to swap between the technologies.
The content in .NET Framework is generally good enough to help someone working in .NET. The docs aren't presented this way, though. When a user is viewing something on .NET Framework, and decides to use the moniker switcher to change to .NET 9, if that article doesn't exist, the user is brought back to the same article in .NET Framework with a little banner at the top that says the page doesn't exist. This is confusing.
I propose that we merge the experiences back together and...
One other thing to note is writing style. Microsoft's writing style isn't as formal as it was 10-15 years ago when the .NET Framework content was written. New articles are straight to the point and use a more relaxed style. Articles in the content set will greatly differ after the merge.
One thing I'm not sure of is reporting. Currently this docset uses two services: dotnet-desktop and dotnet-framework. These were used to differentiate the new content from the old, where the focus was .NET and the older content lived under a different SLA. I propose these two services remain. As content is copy-edited and rewritten for .NET it moves from one service to the other. Eventually the .NET Framework service area would be trimmed down. Content rewritten in the new style can still talk about .NET Framework, but by moving to the dotnet-desktop service area, it indicates that it's fresh and follows the latest style guide.
@KlausLoeffelmann @merriemcgaw @MelonWang1 @Tanya-Solyanik
Related issues (which I'll close and use this one to track)
#2015
#1915
Tagging others who've commented
@BPowell76 @Prologh @siimaus
Associated WorkItem - 419052
The text was updated successfully, but these errors were encountered: