Page MenuHomePhabricator

Test the Codex components pages with internal users and analyze the results
Closed, ResolvedPublic

Description

Background

The DST wants to test the component pages in Codex with different types of users, including designers, developers, and other users, to ensure that the content of the component pages is clear when searching for information and easily navigable for the types of users who use the Codex site.

Usability test plan

Usability testing findings

Based on the test results, we need to reconsider the following aspects of the Codex components pages:

  • Evaluate the visibility of the Tabs to ensure its findability if we finally use them to separate "Guidelines" and "Code" in the components pages.
  • Consider renaming the "Using" section for clarity.
  • Improve the findability of min-max limitations by including a title like "Component limitations" for easier scanning.
  • Keep the "Interaction States" section as it is since users found it helpful.
  • Include a new "See Also" section with relevant connected links.
  • Move the "Vue Props" section to the top of the "Code" tab since developers found this section as the most relevant fro them.
  • Keep the configurable demo in the "Guidelines" tab but give it a clear title like "Configurable demo" or "Interactive demo" for better understanding.
  • Redesign the props configuration in the configurable demo to improve its usability, especially for non-developer users.

Acceptance Criteria (or Done)

  • Conduct the test
  • Analyze the results and extract insights

Event Timeline

CCiufo-WMF renamed this task from Test the Codex components pages with intern users and analyze the results to Test the Codex components pages with internal users and analyze the results.Apr 29 2024, 2:54 PM
CCiufo-WMF triaged this task as Medium priority.Apr 29 2024, 2:57 PM
bmartinezcalvo updated the task description. (Show Details)

The usability testing sessions with 5 participants were conducted and the findings and insights have been analyzed in this deck. Based on the test results, we need to reconsider the following aspects of the Codex components pages:

  • Evaluate the visibility of the Tabs to ensure its findability if we finally use them to separate "Guidelines" and "Code" in the components pages.
  • Consider renaming the "Using" section for clarity.
  • Improve the findability of min-max limitations by including a title like "Component limitations" for easier scanning.
  • Keep the "Interaction States" section as it is since users found it helpful.
  • Include a new "See Also" section with relevant connected links.
  • Move the "Vue Props" section to the top of the "Code" tab since developers found this section as the most relevant fro them.
  • Keep the configurable demo in the "Guidelines" tab but give it a clear title like "Configurable demo" or "Interactive demo" for better understanding.
  • Redesign the props configuration in the configurable demo to improve its usability, especially for non-developer users.

I'm solving this task. Future tasks can be created to explore the improvements of the Codex components pages based on these findings.