From 92a60e0abc9e98848d980f7b6c7171dcd137810b Mon Sep 17 00:00:00 2001 From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com> Date: Fri, 23 Jan 2026 11:18:44 -0500 Subject: [PATCH 1/3] docs(terminology): Add guidance around trademarked terms. --- .../content-design/grammar/terminology.md | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/packages/documentation-site/patternfly-docs/content/content-design/grammar/terminology.md b/packages/documentation-site/patternfly-docs/content/content-design/grammar/terminology.md index ee74c5b6b8..99eb9d9e0a 100644 --- a/packages/documentation-site/patternfly-docs/content/content-design/grammar/terminology.md +++ b/packages/documentation-site/patternfly-docs/content/content-design/grammar/terminology.md @@ -4,11 +4,25 @@ section: content-design subsection: grammar --- -This resource overviews common UI terms and their usage. +This resource overviews common UI terms and their usage. Do not precede any terms in a UI with "please" as it is extraneous and overly formal. For Red Hat product terminology and documentation standards, see [Red Hat's supplementary style guide for product documentation](https://redhat-documentation.github.io/supplementary-style-guide/#introduction). -**Note:** Do not precede UI terms with "please." It is extraneous and overly formal. +## Trademarked terms + +You can use third-party trademarked terms (including those of competitors) when necessary to describe their goods and services accurately, or to prevent marketplace confusion between Red Hat and third parties.. + +When using trademarks: +- Avoid using them as attention-getting devices. +- Ensure their usage does not mislead users. +- Use them only to objectively compare relevant and verifiable goods or services. +- Do not discredit or denigrate a competitor's trademarks, trade names or other distinguishing signs. +- Do not take unfair advantage of a competitor's trademark. +- Do not present goods or services as imitations or replicas of trademarked products. +- Limit trademark usage to body text rather than headlines, titles, or graphics. +- Never use a third party's logo without explicit permission. + +## Glossary
From 063e569b253423c3b15b5e0612c33bb1861c8754 Mon Sep 17 00:00:00 2001 From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com> Date: Mon, 2 Feb 2026 11:54:34 -0500 Subject: [PATCH 2/3] Adds example. --- .../content/content-design/grammar/terminology.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/packages/documentation-site/patternfly-docs/content/content-design/grammar/terminology.md b/packages/documentation-site/patternfly-docs/content/content-design/grammar/terminology.md index 99eb9d9e0a..b3adacb735 100644 --- a/packages/documentation-site/patternfly-docs/content/content-design/grammar/terminology.md +++ b/packages/documentation-site/patternfly-docs/content/content-design/grammar/terminology.md @@ -22,6 +22,10 @@ When using trademarks: - Limit trademark usage to body text rather than headlines, titles, or graphics. - Never use a third party's logo without explicit permission. +| Before | After | +| :---: | :---: | +| Unlike the overcomplicated and overpriced Competitor®, our solution is both easy to use and affordable. | While Competitor® provides robust support for virtualization, our solution offers more integrated support for containerized environments. | + ## Glossary
From 1e66490633cf8855f93391827bd4759ec48949a7 Mon Sep 17 00:00:00 2001 From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com> Date: Tue, 3 Feb 2026 10:22:20 -0500 Subject: [PATCH 3/3] Add more realistic example. --- .../content/content-design/grammar/terminology.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/documentation-site/patternfly-docs/content/content-design/grammar/terminology.md b/packages/documentation-site/patternfly-docs/content/content-design/grammar/terminology.md index b3adacb735..e4d0bd8d0c 100644 --- a/packages/documentation-site/patternfly-docs/content/content-design/grammar/terminology.md +++ b/packages/documentation-site/patternfly-docs/content/content-design/grammar/terminology.md @@ -24,7 +24,7 @@ When using trademarks: | Before | After | | :---: | :---: | -| Unlike the overcomplicated and overpriced Competitor®, our solution is both easy to use and affordable. | While Competitor® provides robust support for virtualization, our solution offers more integrated support for containerized environments. | +| Why settle for VMware’s slow boot times? Our platform is 20% faster and costs half as much as their legacy junk. | In independent benchmarks, Red Hat OpenShift demonstrated 20% faster deployment times compared to VMware vSphere. Our solution offers a verifiable cost-efficiency advantage for enterprise-scale workloads.| ## Glossary