Skip to content

Commit bae3675

Browse files
fix(get-help): Adds Get help section to site. (#4866)
* fix(get-help): Adds Get help section to site. * Update packages/documentation-site/patternfly-docs/patternfly-docs.config.js * Resolve connect section of nav --------- Co-authored-by: Nicole Thoen <nthoen@redhat.com>
1 parent 23ad971 commit bae3675

File tree

5 files changed

+185
-1
lines changed

5 files changed

+185
-1
lines changed
Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
---
2+
id: Contact us
3+
section: get-help
4+
---
5+
6+
The PatternFly team is available to help answer any questions that you can't find the answer to on our website. There are a couple of ways to get in touch with our team quickly.
7+
8+
## Before you reach out, check out our resources
9+
10+
We eagerly welcome Flyers to reach out to us and start discussions, but it's a great first step to explore our resources and search our comprehensive website documentation for answers to your questions.
11+
12+
In addition to the detailed design guidelines you can find on our website for components, extensions, patterns, and foundational practices, we publish answers to frequently asked questions in [our FAQs guide.](/get-help/faqs). While we can't predict every question you may have, this guide addresses some of the most common ones.
13+
14+
## Join our office hours
15+
16+
Every two weeks, the PatternFly team sets aside time to address any questions or issues presented by Flyers in our design and development office hours. To keep track of our meeting schedule, [add our Google Calendar to yours](https://calendar.google.com/calendar/embed?src=patternflyteam%40gmail.com&ctz=America%2FNew_York).
17+
18+
Any PatternFly-related topic is welcome at this meeting, where you can directly talk face to face with the team that builds and maintains PatternFly. Topics often include questions specific to a design and development challenge, with many attendees presenting in-progress work for feedback.
19+
20+
If there's something you'd like to discuss in this meeting, [sign up for a topic in advance](https://docs.google.com/document/d/16ltdRXX4U-FLunZpPdmQjATZHUTxjyTh-BGsoqdFKTs/edit?tab=t.0#heading=h.fdgi7w700vmz), so that we can plan ahead and predict the amount of time each topic will take. If you have something to share at this meeting, but you can't make it, you can have someone else come and present on your behalf.
21+
22+
## Reach out to the team
23+
24+
The best way to reach the team is to [join the PatternFly Slack workspace](https://join.slack.com/t/patternfly/shared_invite/zt-3dcejyvj6-MU93z8IVihJXxbs2ggrMEw). If you're a Red Hatter, you can also reach out on the [#list-patternfly](https://redhat.enterprise.slack.com/archives/C04JMHKSD9C) channel within the Red Hat Internal workspace.
25+
26+
There are a few PatternFly Slack channels to reach out to us on:
27+
- For general questions and help: [#general](https://patternfly.slack.com/archives/C293LQ36J)
28+
- For questions about design: [#patternfly-design](https://patternfly.slack.com/archives/CGR204RM2)
29+
- For HTML/CSS library questions: [#patternfly-core](https://patternfly.slack.com/archives/C9Q224EFL)
30+
- For React library questions: [#patternfly-react](https://patternfly.slack.com/archives/C4FM977N0)
Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
---
2+
id: FAQs
3+
section: get-help
4+
source: General
5+
sortValue: 1
6+
---
7+
8+
This guide provides answers to some of the questions new Flyers may have, as well as common questions the PatternFly team receives from the community. If there's a question that you believe should be addressed in these FAQs, [reach out to the PatternFly team.](/get-help/contact-us)
9+
10+
## General FAQs
11+
12+
### About PatternFly
13+
14+
For more information about PatternFly, [check out our "About" page.](/about-us)
15+
16+
#### What is PatternFly and who can use it?
17+
18+
PatternFly is an open source design system for enterprise software. PatternFly is maintained by Red Hat and is used extensively across Red Hat products, but anyone can use or contribute to PatternFly.
19+
20+
#### Who works on PatternFly?
21+
22+
The PatternFly team is part of Red Hat's User Experience Design team and is composed of more than 20 designers, developers, and writers.
23+
24+
#### How often is PatternFly updated?
25+
26+
We publish a major release when we need to release breakings changes that will require significant consumer updates that will alter the way your product's code interacts with PatternFly. These are our single version numbers, like PatternFly 4, 5, or 6.
27+
28+
We publish a minor release each quarter to introduce non-breaking changes, including enhancements, bug fixes, and new features. These increase the sub-version of a major release, like PatternFly 6.1, 6.2, or 6.3.
29+
30+
We occasionally share patch releases between our quarterly minor releases for timely bug fixes that can't wait until the end of the quarter. These increase the sub-version of a minor release, like PatternFly 6.1.1, 6.1.2, or 6.1.3.
31+
32+
#### What is the latest version of PatternFly?
33+
34+
We are currently on version 6 of PatternFly&mdash;also known as "PatternFly 6". You can view the current minor and patch release version within [our release highlights.](https://www.patternfly.org/releases/release-highlights)
35+
36+
### Contributing
37+
38+
#### How can I contribute to PatternFly?
39+
40+
You can contribute to the design and development of PatternFly, including new features as well as assisting with existing backlog issues. For more details, [refer to our contribution guidelines.](/get-involved/contribute/contribute-code)
41+
42+
#### How can I report a bug that I've found?
43+
44+
We encourage you to share the details of any potential bug that you'd found in your products. To alert the team, [follow our bug report guidelines.](/get-help/report-a-bug)
45+
46+
#### When can I expect my bug report to be addressed?
47+
48+
Our team regularly triages new bug reports based on severity and product impact. While we do our best to address critical bugs quickly, providing clear details and any relevant deadlines in your report helps us prioritize effectively. [Follow our bug report guidelines](/get-help/report-a-bug) to alert the team about an issue.
49+
50+
## Designer FAQs
51+
52+
### What design resources are available for PatternFly 6?
53+
54+
The PatternFly 6 design kit is fully supported within our Figma libraries:
55+
- [Components](https://www.figma.com/community/file/1357060119827689328/patternfly-6-components)
56+
- [Patterns and extensions](https://www.figma.com/community/file/1357062621908564852/patternfly-6-patterns-extensions)
57+
58+
To learn how to use our Figma libraries, [refer to our Design Kit Onboarding Resources guide.](https://www.figma.com/community/file/1357056715773763430/patternfly-6-onboarding-resources)
59+
60+
### How can I ensure cross-product design consistency?
61+
62+
For maximum consistency, always start with PatternFly's official component and [pattern guidelines.](/patterns/overview) If your product has specific needs that require deviation, check for established product-specific patterns on [the UXD Hub.](https://www.uxd-hub.com/) before creating a new one. This ensures alignment across the broader Red Hat ecosystem.
63+
64+
## Developer FAQs
65+
66+
### Which browsers are supported?
67+
68+
PatternFly is supported on the 2 latest major versions of the following browsers:
69+
70+
- Chrome
71+
- Firefox
72+
- Safari
73+
- Edge
74+
75+
### What languages are supported?
76+
77+
We offer both HTML/CSS and React implementations for our components. We support React 17, 18, and 19 in PatternFly 6.
78+
79+
### Where can I find documentation for previous versions
80+
81+
You can navigate to the documentation for previous PatternFly versions using the version switcher in the masthead of our website. Note that we no longer maintain this documentation, with the exception of critical bug fixes in the major release prior to our current version.
82+
83+
[PatternFly 3](https://pf3.patternfly.org/)
84+
[PatternFly 4](https://v4-archive.patternfly.org/v4/)
85+
[PatternFly 5](https://v5-archive.patternfly.org/)
Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
---
2+
id: Report a bug
3+
section: get-help
4+
---
5+
6+
7+
If you believe you've found a bug in PatternFly, we appreciate you taking the time to report it so we can resolve the issue.
8+
9+
10+
## Before you file
11+
12+
13+
1. **Check the documentation:** First, view the documentation for the component or feature to confirm that the behavior you're seeing is not intentional.
14+
1. **Collect clear details:** When you file your report, please include the project or product where you noticed the bug and specify any deadlines the fix is needed for. This helps us triage and prioritize.
15+
16+
17+
## Where to file your bug report
18+
19+
20+
Find the appropriate repo from the following list. For each repo, first search existing issues to see if your bug has already been reported. If not, open a new issue.
21+
22+
23+
### Design issues
24+
Issues related to PatternFly's visual and interaction design should be contained in the [patternfly-design repo.](https://github.com/patternfly/patternfly-design/issues)
25+
26+
27+
- [Search existing design issues](https://github.com/patternfly/patternfly-design/issues?q=is%3Aissue+is%3Aopen+)
28+
- [Open a new design issue](https://github.com/patternfly/patternfly-design/issues/new)
29+
30+
31+
### React issues
32+
Bugs that are present *only* in the React implementation of a component should be contained in the [patternfly-react repo.](https://github.com/patternfly/patternfly-react/issues)
33+
34+
35+
- [Search existing React issues](https://github.com/patternfly/patternfly-react/issues?q=is%3Aissue+is%3Aopen+)
36+
- [Open a new React issue](https://github.com/patternfly/patternfly-react/issues/new)
37+
38+
39+
### HTML/CSS (Core) issues
40+
Bugs that appear in the base HTML/CSS or can be seen in *both* the React and HTML versions should be contained in the [patternfly (Core) repo.](https://github.com/patternfly/patternfly/issues)
41+
42+
43+
- [Search existing Core issues](https://github.com/patternfly/patternfly/issues?q=is%3Aissue+is%3Aopen+)
44+
- [Open a new Core issue](https://github.com/patternfly/patternfly/issues/new)
45+
46+
47+
### Extension issues
48+
For bugs found in a PatternFly extension, please file the issue in that extension's specific repository:
49+
50+
51+
- [chatbot:](https://github.com/patternfly/chatbot) Code for [the ChatBot extension](/patternfly-ai/chatbot/about-chatbot).
52+
- [patternfly-quickstarts:](https://github.com/patternfly/patternfly-quickstarts). Code for [the quick starts extensions](/extensions/quick-starts).
53+
- [react-catalog-view:](https://github.com/patternfly/react-catalog-view) Code for [the catalog view extension](/extensions/catalog-view/catalog-item-header).
54+
- [react-component-groups:](https://github.com/patternfly/react-component-groups) Code for [the component groups extension](/component-groups/about-component-groups).
55+
- [react-data-view:](https://github.com/patternfly/react-data-view) Code for [the data view extension](/extensions/data-view/overview).
56+
- [react-log-viewer:](https://github.com/patternfly/react-log-viewer) Code for [the log viewer extension](/extensions/log-viewer).
57+
- [react-topology:](https://github.com/patternfly/react-topology) Code for [the Topology extension](/topology/about-topology).
58+
- [react-user-feedback:](https://github.com/patternfly/react-user-feedback) Code for [the user feedback extension](/extensions/user-feedback).
59+
60+
61+
### Website issues
62+
Bugs related to the PatternFly.org website or its documentation should be contained in the [patternfly-org repo.](https://github.com/patternfly/patternfly-org/issues)
63+
64+
65+
- [Search existing website issues](https://github.com/patternfly/patternfly-org/issues?q=is%3Aissue+is%3Aopen+)
66+
- [Open a new website issue](https://github.com/patternfly/patternfly-org/issues/new)

packages/documentation-site/patternfly-docs/patternfly-docs.config.js

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,11 +54,13 @@ if (process.env.EXTENSIONS_ONLY === 'true') {
5454
{ section: 'AI' },
5555
{ section: 'content-design' },
5656
{ section: 'developer-guides' }
57-
]
57+
],
58+
hasDivider: true
5859
},
5960
{
6061
title: 'Connect',
6162
items: [
63+
{ section: 'get-help' },
6264
{ section: 'get-involved' }
6365
]
6466
}

packages/documentation-site/patternfly-docs/patternfly-docs.source.js

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,7 @@ module.exports = (sourceMD, sourceProps, sourceFunctionDocs) => {
2222

2323
sourceMD(path.join(contentBase, 'AI/**/*.md'), 'AI');
2424

25+
sourceMD(path.join(contentBase, 'get-help/**/*.md'), 'get-help');
2526
sourceMD(path.join(contentBase, 'get-involved/**/*.md'), 'get-involved');
2627

2728
// Landing pages (now in their respective content folders)

0 commit comments

Comments
 (0)