Pajamas website refresh
Why?
The Pajamas website has met our needs to this point, but there are several feature lacking if we want it to be the go-to resource we want it to be.
What
Here are a few ways that the site could be improved:
Responsive
We need to consider responsive behavior and patterns more holistically. The current site has some responsive behavior, but many features and views are unreliable.
Search
There is currently no way to search on the site. It would be helpful to have both tagged and full content search available.
Accessibility
There are several things to consider here, but one of the main ones is the navigation. A <details> element is used for some of the navigation, and could benefit from an update. Making more use of landmarks and regions could help too.
Dogfooding GitLab UI
The site uses separate styles from GitLab UI. The site instead should be a testing ground for GitLab UI styles and components. This would also help prevent the need to duplicate some styles (like colors) which can easily get out of sync. It would also be great to have GitLab UI feel more integrated and less like an embed or a reference. If the site was built on Vue, could we build out examples the same way they’re included in the product with templating instead of pulling from Storybook?
Reliability
This error happens often when viewing the public site.
More visual and contextual examples
The site is very text-heavy, and users would benefit from concepts also being represented visually. This doesn’t mean we have to use literal UI screenshots that could become out of date, but representative visuals that demonstrate concepts in a more timeless way.
| Before | After |
|---|---|
 |
 |