diff --git a/packages/documentation-site/patternfly-docs/content/components/label/img/deprecated-label.svg b/packages/documentation-site/patternfly-docs/content/components/label/img/deprecated-label.svg new file mode 100644 index 0000000000..6c64417ef1 --- /dev/null +++ b/packages/documentation-site/patternfly-docs/content/components/label/img/deprecated-label.svg @@ -0,0 +1,26 @@ + diff --git a/packages/documentation-site/patternfly-docs/content/components/label/img/preview-labels.svg b/packages/documentation-site/patternfly-docs/content/components/label/img/preview-labels.svg new file mode 100644 index 0000000000..115f1d8b44 --- /dev/null +++ b/packages/documentation-site/patternfly-docs/content/components/label/img/preview-labels.svg @@ -0,0 +1,68 @@ + diff --git a/packages/documentation-site/patternfly-docs/content/components/label/label.md b/packages/documentation-site/patternfly-docs/content/components/label/label.md index bb6805d5cb..f046fc94bd 100644 --- a/packages/documentation-site/patternfly-docs/content/components/label/label.md +++ b/packages/documentation-site/patternfly-docs/content/components/label/label.md @@ -63,6 +63,35 @@ Labels are typically used in filter and selection use cases to indicate what sel  +#### Beta and preview labels + +To communicate that a feature is in a beta or preview mode, rather than fully released and supported, use a [nonstatus purple label](#nonstatus-labels). + +There are a few common types of preview labels: +1. **Developer preview:** Shared for early evaluation and feedback. These features are likely unstable, unsupported, and not ready for production environments. +2. **Technology preview:** Ready for early use and feedback. These features have limited support and are typically on the roadmap for a future full release. +3. **Beta:** Publicly available but still subject to change. Beta features are typically feature-complete but might still undergo visual or functional changes based on user feedback before being promoted to full support. + +Beta and preview labels should use the compact size variant and should be placed beside the title of the new feature or component—ideally to the right of the title. + +Preview labels should be clickable. When clicked, display a popover with a brief explanation of the preview type (stability, potential limitations) and a "Learn more" to dedicated documentation. + +