Page MenuHomePhabricator

docs: Analyze the "Choose a component" tool
Open, Needs TriagePublic

Description

Background

During the January 2025 Sprinthackular, the "Choose a component" tool was created to guide users through a survey to help them identify a component they might be looking for.

Goal

We should analyze this tool and determine if it is something we would want to refine and add to the docs site.

Considerations

  • The patch with the demo was written during hackathon and should be cleaned up before considering for code review, even as an MVP. @SToyofuku-WMF can be consulted from an engineering perspective.
  • We should consider the maintenance factor of a tool like this. When we add a new component or revise specific guidance for an existing component, this would need to be updated.
  • In the future, we could also consider a more visual version that might be more helpful, but new component variants might be needed for this concept, such as a selectable Card.

Acceptance criteria

  • Discuss and decide if this tool should belong on the Codex docs site
  • If so, clean up the existing code to get the current patch production ready for a proper code review

Details

Related Changes in Gerrit:

Event Timeline

Change #1115105 had a related patch set uploaded (by Stoyofuku-wmf; author: Stoyofuku-wmf):

[design/codex@main] [WIP] Sprinthackular Team 1 Project

https://gerrit.wikimedia.org/r/1115105

Change #1115105 abandoned by Stoyofuku-wmf:

[design/codex@main] [WIP] Sprinthackular Team 1 Project

Reason:

Going to abandon this as I'm 99% sure it will still preserve everything

https://gerrit.wikimedia.org/r/1115105