Skip to content

Delete C++/CLI snippets where not needed #45892

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

Open
gewarren opened this issue Apr 22, 2025 · 0 comments
Open

Delete C++/CLI snippets where not needed #45892

gewarren opened this issue Apr 22, 2025 · 0 comments
Assignees
Labels
📌 seQUESTered Identifies that an issue has been imported into Quest.

Comments

@gewarren
Copy link
Contributor

gewarren commented Apr 22, 2025

Describe the issue or suggestion

In the "old days", we always added API examples to the .NET docs in three languages: C#, VB, and C++/CLI. Today, we primarily add snippets in C#, sometimes also VB, and never in C++/CLI. We’ve also never had a customer request for a C++/CLI code example.

As far as maintenance goes, if one of these older code snippets needs to be updated, then it needs to be updated in 3 languages. Also, many of these code examples use now-obsolete APIs and/or outdated syntax. Given that C++/CLI has numerous restrictions on .NET (Core) (for example, it only runs on Windows) and doesn’t seem to be commonly used except as a thin interop layer, we propose deleting the C++/CLI snippets from the .NET docs except for in the following areas:

• Interop docs
• .NET Framework-specific docs


Associated WorkItem - 423793

@gewarren gewarren self-assigned this Apr 22, 2025
@dotnet-policy-service dotnet-policy-service bot added the ⌚ Not Triaged Not triaged label Apr 22, 2025
@gewarren gewarren added the okr-curation OKR: Curate content to remove outdated recommendations label Apr 22, 2025
@dotnetrepoman dotnetrepoman bot added the 🗺️ mapQUEST Only used as a way to mark an issue as updated for quest. RepoMan should instantly remove it. label Apr 22, 2025
@gewarren gewarren moved this from 🔖 Ready to 🏗 In progress in dotnet/docs April 2025 sprint project Apr 22, 2025
@gewarren gewarren added 🗺️ reQUEST Triggers an issue to be imported into Quest. and removed ⌚ Not Triaged Not triaged okr-curation OKR: Curate content to remove outdated recommendations labels Apr 22, 2025
@dotnet-policy-service dotnet-policy-service bot removed the 🗺️ mapQUEST Only used as a way to mark an issue as updated for quest. RepoMan should instantly remove it. label Apr 22, 2025
@sequestor sequestor bot added 📌 seQUESTered Identifies that an issue has been imported into Quest. and removed 🗺️ reQUEST Triggers an issue to be imported into Quest. labels Apr 23, 2025
@dotnetrepoman dotnetrepoman bot added the 🗺️ mapQUEST Only used as a way to mark an issue as updated for quest. RepoMan should instantly remove it. label Apr 25, 2025
@dotnet-policy-service dotnet-policy-service bot removed the 🗺️ mapQUEST Only used as a way to mark an issue as updated for quest. RepoMan should instantly remove it. label Apr 25, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
📌 seQUESTered Identifies that an issue has been imported into Quest.
Projects
Status: 🏗 In progress
Development

No branches or pull requests

1 participant