about_Classes doesn't mention the Experimental or System.Obsolete attributes

[michaeltlombardi]

Prerequisites

• Existing Issue: Search the existing issues for this repository. If there is an issue that fits your needs do not file a new one. Subscribe, react, or comment on that issue instead.
• Descriptive Title: Write the title for this issue as a short synopsis. If possible, provide context. For example, "Typo in Get-Foo cmdlet" instead of "Typo."
• Verify Version: If there is a mismatch between documentation and the behavior on your system, ensure that the version you are using is the same as the documentation. Check this box if they match or the issue you are reporting is not version specific.

Links

• https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_classes

Summary

The about_Classes article discusses several useful attributes and practices for developing PowerShell classes, but it doesn't cover using the Experimental attribute to mark a class or property as experimental, nor using the System.Obsolete attribute to mark a class, property, or method as obsolete.

Both practices are useful for PowerShell developers and can impact the user experience for their modules and classes.

Details

A common development need is to mark new functionality as experimental or replaced functionality as obsolete. Further, PowerShell developers might want to build functionality on PowerShell's own experimental features.

Suggested Fix

Extend the documentation in about_Classes to cover experimental and obsolete classes and class members.