Our content isn't baked in to components or code the way our foundations are. So, Workforce EPD needs to create the content for its products in addition to designing and coding. Using these guidelines will help teams create on-brand and best-practice compliant content.
Pages like Writing for product and Sign-In Widget provide step-by-step guidance to create content. Other pages, like Voice and tone, Grammar and mechanics, and the Product glossary, provide granular information to answer specific content design questions.
Content guidance
Writing for product
Prepare to write and create on-brand, best practice content for Workforce experiences.
Voice and tone
Learn what to say and how to say it so our written content consistently sounds like Okta.
Grammar and mechanics
Follow the grammar guidelines and rules to ensure our written content is clear and consistent.
Common actions
Describe the actions that appear across WIC features and products using these established verbs to achieve and maintain platform consistency.
Product glossary
Use Okta vocabulary consistently in Workforce experiences and avoid words with inclusivity, accessibility, and translation issues.
Errors
Write error messages that help users understand what went wrong and how to fix it.
Sign-In Widget
Create content that introduces end-users to the SIW experience and helps them complete it quickly and easily.
Empty states
Create helpful, clear, positive content for our three types of empty states.
Naming
Name products and features to teach people how to use them and find the things they need.
Writing for Okta AI
Learn how we’re starting to develop AI content that creates a conversation with the user by being responsive to user input and helpful.
Have questions or need support?
Oktanauts can use the following resources when building with Odyssey:
- Check the Odyssey 1.0 FAQs.
- Join #odyssey in Slack and tag @content to ask questions.
- Attend Odyssey Office Hours on Mondays and Wednesdays from 1-1:30 p.m. PT / 4-4:30 p.m. ET.
- Submit bug reports and feature requests to the Odyssey Jira board
- Request a new component using the Odyssey component proposal.