Documentation should not redirect to .NET 4.8 documentation if it doesn't apply to .Net 3+ Winforms. #8866
Labels
area-VSDesigner
Windows Forms out-of-proc designer related issues
📚 documentation
Documentation bug or improvement
Environment
learn.microsoft.com
Microsoft Visual Studio Enterprise 2022
Version 17.5.0
VisualStudio.17.Release/17.5.0+33414.496
Microsoft .NET Framework
Version 4.8.09032
.NET version
.NET 6+
Did this work in a previous version of Visual Studio and/or previous .NET release?
Yes, the docs are correct for .NET 4.8
Issue description
Users evaluating .NET 6/7 will search the internet and find documentation on learn.microsoft.com (but for .NET 4.8)
They use the combobox to select .NET 6/7 and are redirected back to the 4.8 documentation.
When it is wrong, they assume nothing has changed and the documentation is relevant for them.
They don't go to the Github repro and check the wiki/docs there that are more correct.
They get confused and call Microsoft.
example, customer wondering why his controls wouldn't show up in the Winform's designer toolbox even though he was following the documentation.
here are a few links in that area.
learn.microsoft.com/en-us/dotnet/desktop/winforms/controls/how-to-display-a-control-in-the-choose-toolbox-items-dialog-box?view=netframeworkdesktop-4.8&viewFallbackFrom=netdesktop-6.0
https://learn.microsoft.com/en-us/dotnet/desktop/winforms/controls/walkthrough-automatically-populating-the-toolbox-with-custom-components?view=netframeworkdesktop-4.8&viewFallbackFrom=netdesktop-6.0
https://learn.microsoft.com/en-us/dotnet/desktop/winforms/controls/how-to-display-a-control-in-the-choose-toolbox-items-dialog-box?view=netframeworkdesktop-4.8&viewFallbackFrom=netdesktop-6.0
Steps to reproduce
Expected Results
No documentation
Actual Results
Still looking at the 4.8 docs even though things don't work that way anymore, but thinking they still apply.
We need correct documentation.
Diagnostics
The text was updated successfully, but these errors were encountered: