Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Content guidelines #859

Closed
janchild opened this issue Jan 28, 2020 · 0 comments
Closed

Content guidelines #859

janchild opened this issue Jan 28, 2020 · 0 comments
Assignees
Labels
Epic Special label used by ZenHub for epic functionality role: content 📝 type: docs 📖

Comments

@janchild
Copy link
Contributor

janchild commented Jan 28, 2020

Issues inside this epic will include the following topics:

  • Setting content strategy with Mary Brooks, enterprise content strategist to determine Carbon's role in the IBM content ecosystem
  • Research product teams' content guidelines (internal sites) and determine what lives where
  • New topics to be included:
    • Where to find different types of content guidance—for example, voice and tone per product
    • UI text (the definitive set of rules including what types of information live where)
    • Inclusive terminology
    • Writing for accessibility
    • Principles
    • Mechanics:
      • Capitalization
      • Punctuation
      • Word choices
      • Numbers and measurements
    • General writing principles

Also look at the content guidance in individual components and make sure there is a consistent approach for what lives where.

Full audit of all images and the content included.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Epic Special label used by ZenHub for epic functionality role: content 📝 type: docs 📖
Projects
None yet
Development

No branches or pull requests

2 participants