Page MenuHomePhabricator

[Epic] Toolforge UI: Discovery
Closed, ResolvedPublic

Description

Background

The Toolforge modernization initiative aims to streamline and simplify the workflows of current and prospective users by providing them with an interface that makes essential functionality more accessible.

In order to further validate this opportunity and inform its scope, we’ll rely on lean research techniques to understand the problems affecting the different Toolforge user groups during their tooling set up and maintenance processes. As well as to detect opportunities from competitors.

We’ll draw on collaborative exercises to assess and prioritize the key areas of improvement of Toolforge’s workflows, based on our findings. Research insights will inform the creation of a prioritized list of features that will later guide the conceptualization of a first prototype of Toolforge’s UI.

Goals

Primary Goal

  • Identify key areas for improvement in the current workflows of Toolforge users, to inform the scoping and conceptualization of a UI for Toolforge

Secondary Goals

  • Validate the value proposition of Toolforge modernization with current and potential users
  • Create working definitions of the different Toolforge user groups to ensure that their diverse goals and needs are addressed, along with their specific pain points.
Methodology

The discovery process is divided into two primary phases:

  1. Lean Research:

1.1. Conduct stakeholder and user interviews to understand current pain points, goals, and non-negotiable functionalities for Toolforge users.
1.2. Perform desk research using relevant documentation and feedback from past surveys, chat logs, and meeting notes.
1.3. Analyze competitors (Heroku, Vercel, Netlify) to identify features and solutions that could inspire opportunities

  1. Opportunity Assessment and Solution Scoping:

2.1. Hold collaborative sessions with the Toolforge team to generate and assess opportunities based on research findings.
2.2. Prioritize issues per user profile and shape them into user stories.

Document and communicate findings to the community, followed by planning further phases such as design, testing, and implementation.

Resources
Acceptance criteria
  • We complete stakeholder and user interviews
  • Competitor analysis is completed and documented
  • Key issues and opportunities are documented, shared and assessed with help from stakeholders
  • Features to address opportunities and pain points are documented in a prioritized list

Event Timeline

Sarai-WMF renamed this task from WE6.3.3: Toolforge Modernization Discovery to [Hypothesis] WE6.3.3: Toolforge Modernization Discovery.Sep 27 2024, 6:06 PM
Sarai-WMF claimed this task.
Sarai-WMF renamed this task from [Hypothesis] WE6.3.3: Toolforge Modernization Discovery to [Hypothesis] WE6.3.6: Toolforge Modernization Discovery.Oct 9 2024, 9:23 AM
Sarai-WMF updated the task description. (Show Details)
fnegri triaged this task as High priority.Nov 11 2024, 11:54 AM
Sarai-WMF renamed this task from [Hypothesis] WE6.3.6: Toolforge Modernization Discovery to [Epic] Toolforge UI: Discovery.Dec 16 2024, 11:50 AM

The discovery phase concluded the past quarter. Linking all relevant deliverables:

  • Toolforge user journey map – A framework that provides an overview of the steps involved in the registration and configuration of Toolforge tools. With focus on the assumed/documented pain points that affect users at every stage of the journey, and the identification of opportunities that informed the initial mock-ups of the new UI-based solution (linked above).
  • High-level design mock-ups (Figma) – A rapidly evolving design framework providing an overview of Toolforge’s UI potential sections and functionality. The intention is to materialize the opportunities detected while analyzing the current Toolforge user journey. The prototype has been essential to facilitate team discussions, and it'll be key to test our assumptions with help from target users in follow up actions.
  • MVP User Exploration Findings – We conducted sessions with five prospective users to validate the usefulness and usability of our MVP prototype. Their input informed both usability improvements and new feature considerations, which were integrated into the scope document to guide future iterations.
  • Toolforge UI Scope document – We created a detailed, categorized scope of user needs for Toolforge UI, prioritized by their inclusion in the MVP, MVP+, and post-MVP. This living document reflects our product vision, technical constraints, and incorporates feedback from users and subject-matter experts. It serves as a shared reference for planning implementation.
  • Toolforge UI: Requirements document – A living resource capturing both design and technical requirements to ensure alignment on what is to be built and why. The document combines insights from existing community feedback, the analysis of the current experience and technical feasibility assessments.
  • Enhancement proposal page – Wikitech space where we’re sharing updates and gathering feedback from the Toolforge community. We’ll continue posting there: next up is an MVP walkthrough for validation.

For more information and details on the discovery process, please check the final reports of hypotheses WE6.3.6 and WE6.3.8 in Asana (only available internally).