Enabling UX Designers and Developers

Nada El Maliki
Guidewire Design
Published in
6 min readOct 27, 2021

Whether you’re new to design systems or you have experience using a design system in your own practice, you’ve probably asked yourself: How and where can I efficiently learn the basics before embarking on my next project?

In this article, I will share the story of how we, as a cross-functional team at Guidewire, designed and developed an onboarding and enablement experience that served our partners at Guidewire’s first-ever virtual hackathon. Participants were tasked with leveraging Jutro, our P&C focused design system and UI framework, to generate solutions in the area of claims intake and submission. Most had little to no experience using Jutro and came from a variety of different backgrounds: front and backend developers, UX designers, business analysts, and SMEs.

User holding a phone that is displaying a claims-focused application.
Creating claims experiences using the Jutro Design System and UI Framework. ©Guidewire Software

As part of our initial planning and preparations, we created the following How might we question to help us stay focused on the right learner problems and generate creative solutions:

“How might we equip hackathon participants who are new to Jutro with the right tools and knowledge to facilitate design and development of their hackathon applications?”

Illustration that depicts a gap analysis and the skills, tools, and knowledge that are needed to perform an action or achieve a goal.
Skills gap analysis (image credits: Andre Plaut)

Designing for an improved learning experience was not only needed for this hackathon, but also for our larger audience of ongoing and current customers and partners. We had uncovered such a need through extensive research conducted earlier this year, prior to the hackathon, as we sought to better understand the pain points, needs, and goals of Jutro users.

Illustration that depicts user needs statements for a “new to Jutro” UI developer.
User need statements helped us define the problem that we wanted to solve. ©Guidewire Software

The hackathon was an opportunity to bring to life some of the ideas that grew out of this research and make enablement materials available to participating hackathoners.

For designers and developers to successfully build their claims applications using Jutro, it was important provide them with the right assets at the right moment of need. This “just-in-time” (JIT) approach to knowledge acquisition considers key moments in the user’s journey and how we can optimize learning.

Recognizing that instruction is more effective at the point of need, we created a hackathon event and documentation site, along with Jutro Learning Missions, to ensure that content was easy and convenient to access. Each of these assets address specific enablement needs: knowledge discovery and learning.

Hackathon Event Site

The Hackathon event site (aka microsite) was the one-stop shop and point of reference for all stakeholders involved in the hackathon, from internal Guidewire organizers and coaches to external partner participants. In addition to important logistical information, the microsite included welcome videos and event updates, hackathon judging criteria, office hours, and communication channels.

Video preview of the hackathon microsite. ©Guidewire Software

Given the pace of the hackathon, designers and developers had a limited window of time to familiarize themselves with Jutro documentation. The microsite proved invaluable in this regard, as it hosted a more curated and hackathon specific version of our design system docs.

Snapshot of the hackathon microsite with a description of designer and developer docs.
Snapshot of the hackathon microsite with a description of designer and developer docs. ©Guidewire Software

Documentation & Tools for Designers

UX designers had access to the Jutro Design System Sketch library, which includes Jutro components, business patterns, and blueprints. Jutro blueprints are page templates contextualized specifically for the P&C industry. They include out-of-the-box themes that accelerate digital implementations, as well as targeted personas, scenarios, use cases, and wireframes. We also shared detailed design guidelines, usage guidance, and foundational elements that make up the core building blocks of Jutro. All assets came with step-by-step instructions to facilitate application design.

Screenshot of the Jutro design kit in Sketch.
Foundational elements, like Jutro floorplans, were made available via Sketch. ©Guidewire Software

Guidewire’s UX team also assembled an inspiration gallery of insurance claim oriented UIs. The gallery used real business challenges to help illustrate what is possible with Jutro. Ideas ranged from building components to enriching and extending claim details screens, and even a full-blown microapp.

Example from the Inspiration Gallery that focuses on creating a high contrast theme.
Example from the Inspiration Gallery that focuses on creating a high contrast theme. ©Guidewire Software

Documentation & Tools For Developers

Developer documentation treated component variations, states, props, and implementation, while at the same time leveraging tools like Storybook to preview components and business patterns.

Screenshot of Jutro Storybook, which developers used to preview components.
Developers used Storybook to preview components and copy code into their app. ©Guidewire Software

Moreover, developers were given a hackathon application with pre-populated pages showcasing the latest capabilities of Jutro, component code, and application scaffolding.

Micro Videos

In order to accommodate a diverse range of learning styles, we supplemented our instructional content with micro videos that introduce what Jutro is and its key features. Videos covered both designer and developer topics, such as how to use the Jutro component library in Sketch and the basics of configuring Jutro floorplans.

Snapshot of the hackathon microsite with description of video tutorials.
Snapshot of the hackathon microsite with description of video tutorials. ©Guidewire Software

Knowledge Discovery

Problem? -> Browse > look > find…

The hackathon documentation facilitated knowledge discovery by enabling participants to explore information and resources on their own terms. They could leverage the search tool to look for content using keywords or use hackathon communication channels to ask questions about the knowledge gaps or challenges they were facing. Knowledge discovery assets and tools provided contextual help for hackathon participants while they were working on their challenge. Jutro Learning Missions, on the other hand, were dedicated to onboarding and bringing new Jutro users up to speed.

Illustration depicting the difference between knowledge discovery and learning.
Illustration by Kevin McGuire. ©Guidewire Software

Jutro Learning Missions

Jutro Learning Missions offer an easy and effective way for users to skill up and learn the key capabilities of Jutro.

Snapshot of the hackathon microsite with a description of the Learning Missions.
Snapshot of the hackathon microsite with a description of the Learning Missions. ©Guidewire Software

Learning Missions Format:

Video preview of the Learning Missions. ©Guidewire Software

Jutro Learning Missions were short, practical exercises that used multimedia and claims-oriented use cases to teach Jutro basics. They included:

  • Demo Videos: step-by-step walkthroughs on how to perform each mission. These are accompanied by text-based explanations and instructions.
  • Code snippets: Reusable and executable snippets of code that can be directly added to application code.
  • Tip cards: “before you start” and “good to know” tip cards that provide more information and resources for those who want a deeper dive.

Each mission guided participants through specific features of Jutro that they would use to design and develop their hackathon application. In addition, learners gained hands-on experience building a new page from scratch.

Knowledge Discovery vs. Learning Missions

The hackathon enablement assets served two different purposes: onboarding and just-in-time knowledge discovery. They account for differences across personas when it comes to their familiarity and usage of Jutro, workflow, pain points, and points of need for designing and developing applications.

Our Learning and Enablement Journey

Guidewire UX is taking a holistic approach in how, when, and in what format we offer Jutro enablement and learning assets for our internal and external users.

Design thinking principles inform every learning experience that we create, ensuring that the needs, goals, and motivations of Jutro users are always at the forefront of consideration.

--

--

Nada El Maliki
Guidewire Design

Instructional Designer @Guidewire Software — uniting the pillars of pedagogy with the multimedia technology to create powerful learning experiences