Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation should not redirect to .NET 4.8 documentation if it doesn't apply to .Net 3+ Winforms. #8866

Closed
TrevorFellman-MSFT opened this issue Mar 17, 2023 · 3 comments
Assignees
Labels
area-VSDesigner Windows Forms out-of-proc designer related issues 📚 documentation Documentation bug or improvement

Comments

@TrevorFellman-MSFT
Copy link

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

  1. navigate to 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
  2. Change the combobox from .NET Famework 4.8 to .NET 7

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

NA
There is a banner at the top that states...
"The requested page is not available for .NET 6.0. You have been redirected to the newest product version this page is available for."
However, every customer and support engineer I have talked to miss it.  I think it looks too much like an Ad, and we've been trained to ignore content that doesn't look like it's part of the article, but that is just a guess.
@TrevorFellman-MSFT TrevorFellman-MSFT added area-VSDesigner Windows Forms out-of-proc designer related issues untriaged The team needs to look at this issue in the next triage labels Mar 17, 2023
@TrevorFellman-MSFT
Copy link
Author

@merriemcgaw, @adegeo, can you take a look at this as this has/is causing confusion for customers and support engineers. I've already brought this up to Merrie.

@merriemcgaw merriemcgaw self-assigned this Mar 17, 2023
@merriemcgaw merriemcgaw removed the untriaged The team needs to look at this issue in the next triage label Mar 17, 2023
@elachlan elachlan added the 📚 documentation Documentation bug or improvement label Nov 3, 2023
@merriemcgaw
Copy link
Member

@Olina-Zhang do you have the ability to create issues in the dotnet/docs repo? If so, can you please copy this issue there and close this one. Otherwise, let me know and I will.

@MelonWang1
Copy link
Contributor

@merriemcgaw Filed a docs issue dotnet/docs-desktop#1915. Closed this.

@github-actions github-actions bot locked and limited conversation to collaborators Nov 26, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
area-VSDesigner Windows Forms out-of-proc designer related issues 📚 documentation Documentation bug or improvement
Projects
None yet
Development

No branches or pull requests

6 participants