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

[AI] Investigate how best to incorporate documentation on the website for AI variants #3925

Closed
3 tasks done
aagonzales opened this issue Feb 16, 2024 · 2 comments
Closed
3 tasks done

Comments

@aagonzales
Copy link
Member

aagonzales commented Feb 16, 2024

Prompt

Integrated explorations

  • Investigate where and how to add individual component variant documentation
    • Does it need to be both on usage and style? How does this affect the length of the style tab?
    • Is it treated similarly to fluid variants?
    • Does the average designer need to know about the AI styles?
    • How can we clearly communicate who and when someone should use these variants?
  • Determine if we need higher-level AI guidance on the website in the form of a Pattern or Guidelines page.
    • What would be the purpose/goal of that page?
    • Is this where we would reference links to dev assets (react and web components) and documentation?
    • Where is larger "Designing with AI" content going in the future? Do we just link out to that content instead?
  • Do we need to document the AI tokens alongside the core token or elsewhere?

Divergent explorations

  • What if we approach this documentation more independently instead of fully integrated?
    • What if AI had its own L1 section (like data viz) and we addressed usage and styling in a more broad way instead of per component? OR did per component just in this AI section.

Tasks

  • Create example IA, layouts and/or wireframes to illustrate various directions.
  • Playback directions to design team (also AI team?)
  • Determine course of action (if possible)
@github-project-automation github-project-automation bot moved this to 🆕 New in Carbon for AI Feb 16, 2024
@mattrosno mattrosno added this to the Phase 3 - C4AI milestone Feb 19, 2024
@aagonzales aagonzales moved this from 🆕 New to 🏗 In progress in Carbon for AI Feb 27, 2024
@aagonzales aagonzales moved this to 🏗 In Progress in Design System Feb 27, 2024
@aagonzales
Copy link
Member Author

Next steps

  • Flesh out example pages
  • Moving forward either with an L1 + component page OR L2 under guidelines + component page

@thyhmdo thyhmdo moved this from 🏗 In Progress to ✅ Done in Design System Apr 10, 2024
@aagonzales
Copy link
Member Author

Next steps: #3997

@github-project-automation github-project-automation bot moved this from 🏗 In progress to ✅ Done in Carbon for AI Apr 10, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Status: ✅ Done
Archived in project
Development

No branches or pull requests

3 participants