You may have noticed a major change to the Atlassian.design and Atlaskit (AK) websites. What was previously our home for Atlassian Design Guidelines (ADG) has now transformed into our new home for Atlassian Design System.
We’re excited to share with the community some of our favorite new features:
A source of truth
We understand how unpleasant it is to navigate across two sites to find the right information you need. One of the biggest pains for our users is the inconsistencies across our two documentation sites, so we set out to combine them. We’ve begun this journey by launching a single home for our design system documentation at atlassian.design.
Content first, then design
Content is what users need to achieve their goals, and content is what breathes life into a design. Our team has spent a lot of time brainstorming, prioritizing, and mapping out content to user goals. Only then we were able to redesign the site with a fresh look and feel, new layers of navigation, and thoughtful information architecture. We’ve re-written documentation and created clear and comprehensive examples for the first 27 (out of 60) design system components, combining the content for designers and developers into a unified experience.
Laying the foundation
Improving the design and content of atlassian.design is just the tip of the iceberg. Beyond the surface of the redesign, our engineers have also rearchitected the foundation of what our site is built upon. The new site is faster, more reliable, and aligns with Atlassian platform standards. As a platform team, investing in our infrastructure will help us in the future as we continue to scale.
A better user experience
Aside from the new content strategy, redesign, and infrastructure changes, we’ve also made many other improvements to enhance your designer and developer experience:
- Content in context to where you need it
- Easy sharing via click-to-copy heading links
- An improved unified search
- More visual content to break up long chunks of guidance
- …and more coming soon!
What else is new?
As with all large-scale design systems and companies, there were some difficult decisions and changes that we had to make, which is necessary for Atlassian to grow and scale as an organization. We know that these decisions could have been communicated better at the time, and we’re sorry about that. We’re working with the Developer Experience team to do better on this front going forward.
Migrating from Sketch to Figma
We are no longer using Sketch as our primary design tool, as the Atlassian design team has migrated to Figma. Thus, the Sketch library has been deprecated and is no longer supported. You can find our design system foundations, components, and patterns available in our Figma libraries.
Atlaskit repository is private
As of January 2020, the repository for Atlaskit was made private to support the inclusion of Atlassian’s private front-end code. This also means that contributions are closed for now. Not to worry though, our public libraries such as Atlassian Design System, Atlassian Editor, and Atlassian Media can be used via npm packages as before, and a public mirror of the source code is available. Read more about this in the Atlaskit getting started guide.
Previously, a lot of developer “how-to” guides lived publicly on Atlaskit, which were intended for usage by internal Atlassian developers only. This created a source of confusion for external developers, so these misleading guides have been migrated to a private place. (This is separate from the component documentation which is still available on the Atlaskit website).
Where should I go for help?
If you have questions or issues related to the new site, feel free to leave a message here in this thread.
If you want to report a bug or suggest a feature, please start a discussion thread on the Atlassian Developer Community forums (in the Ecosystem Design category). We will monitor the forums and ensure they are addressed by the appropriate maintainers.
The launch of atlassian.design is just the first step in creating a single destination for our documentation and is a big part of our ongoing investment to improve Atlassian Design System.
A few more things we’re excited about:
- Migration of the remaining 30+ design system components (which still live on Atlaskit for now)
- Hardening our visual foundations (color, typography, iconography, spacing)
- Consolidation of content design guidance and standards
- Accessibility improvements which make our site more accessible, usable and inclusive
We hope all of these changes make your experience designing and building experiences at Atlassian so much better. Please let us know what you think!
Atlassian Design System Team