Page MenuHomePhabricator

List of DSG resources to move over (Information Architecture questions)
Closed, DeclinedPublic

Description

Background goal

In T324228 we want to evaluate and propose Codex as Wikimedia Design System. This task is aiming at deciding which Design Style Guide (DSG) resources have priority to be moved into future Codex resource.

User stories

  • As a user I need find valuable information from the established resources in the continuation of Codex as Wikimedia Design System website.

List of resources

DSG (Design Principles)✅ Yes-https://design.wikimedia.org/style-guide/design-principles.html
DSG (Visual Style)✅ Yes-https://design.wikimedia.org/style-guide/visual-style.html
DSG (Content) [TO DO]✅ YesOnce the UX writing guidelines have been added in the DSG we should move them to the new Codex site.-
DSG (Components)⚠️ Not sureShould we include this info or is it enough with each component’s demo page? We could include the design recommendations and specs in each demo page instead.https://design.wikimedia.org/style-guide/components/links.html
DSG (Apps)⚠️ Not sure-https://design.wikimedia.org/style-guide/apps/apps.html
DSG (Resources)✅ Yes-We need to review them and add just the ones we are currently using (Figma libraries)
Other design links⚠️ Not sureDesign blog, Research, Participate… We could add them within the “Design” section.https://design.wikimedia.org/style-guide/resources.html
Design Tokens✅ Yes-https://doc.wikimedia.org/codex/latest/design-tokens/overview.html
Vue components✅ Yes-https://doc.wikimedia.org/codex/latest/components/overview.html
CSS-only components✅ Yes-Link here
OOUI demo⚠️ Not sureIn case of OOUI demo it seems more appropriate to put a message on top of OOUI demos with a link to Codex. Instead of moving the whole resource.https://doc.wikimedia.org/oojs-ui/master/demos/?page=widgets&theme=wikimediaui&direction=ltr&platform=desktop
Contributing✅ Yes-https://doc.wikimedia.org/codex/latest/contributing/overview.html

Acceptance criteria for done

  • Create prioritized list of resources to carry on from the DSG
  • Discuss with the DST team members
  • Discuss with other product design members/leads

Event Timeline

One topic under special consideration is how to deal with the Apps section in the DSG moving forward.

I've started this Notion table to collect here all the resources we are planning to move to the new site. Feel free to edit.

@bmartinezcalvo I'd recommend to move this list from Notion here, for a quick lookup and unified discussion place.

As discussed in T327822, although we wouldn't be "moving" anything, I think we should expand the Codex documentation on-wiki to be more than just "how to use Codex in MW". At that point, we may move the governance model from the DST project page to the Codex one.

@CCiufo-WMF closing this task since all the DSG resources are being moved to Codex in T333437: Create MVP version of DSG documentation in Codex and T333144: [EPIC] Migrate DSG resources to Codex. Feel free to reopen if needed.