Role
UX Designer
Company
Elavon, subsidiary of U.S. Bank
Time Frame
Aug 2018 - Jan 2020
Team Style
Solo Designer
Tools
Sketch, Figma, UserTesting.com, Adobe Illustrator, After Effects
Elavon, subsidiary of U.S. Bank
How do we make our documentation as helpful as possible?
As any developer will tell you, coding without documentation is a bit like flying without a radar. Having clear, concise, and approachable technical documentation not only makes devs lives easier, but it can be used by our sales team as a powerful marketing tool. The previous documentation hub, known as Developer Portal, was lacking in several aspects: visual clarity, performance, accessibility, and the technology had several layers of technical debt. The decision was made to scrap the previous site entirely, and build something completely new: an AWS integrated, markdown powered CMS running on Grav. Elavon has thousands of pages of technical documentation, so converting it from PDF and organizing it was no small undertaking.
I worked with our digital Illustrator Keith Rosemond and my manager Robbie Beers on this project.
This page covers my work as an accessibility specialist. If you are looking for my designer work, you can go here:
Goals
Quickly Browse
Our documentation was originally written for paper, making the content about 50% longer than we needed it to be for web. Quick navigation also requires consistent headings, tables, and diagrams which were not present in the original.
Integrated Code
Syntax highlighted code snippets and executable code samples were a key target for bringing the documentation in line with modern standards. Redoc was used to maintain consistency in our RESTful API specs.
Focus on self-service
We sought to optimize several processes that currently require a phone call, from scoping a customer's payment integration to getting test card data to run dummy transactions.
Information Architecture
Style Guide
Personas
User Journey
Sketches
Landing page

Landing page continued

Products

Transaction APIs

404 page not found

Plugin marketplace

Let's get in touch

Contact us

Contact us continued

Sign on/sign up

Password reset

Forgot password

Low Fidelity Mockups
High Fidelity Mockups
Dark Mode
Mobile High Fidelity Mockups
All designs in this project were required to be fully responsive. 4K and tablet designs are omitted for brevity.
Home
API Products
Customer Service
Transaction APIs
Contact Form
Animations
Animations to enhance the API product categories.
Tools: Adobe Ilustrator, After Effects
Original graphic illustrations drawn by Keith Rosemond. All Rights Reserved.
Animations to add movement to U.S. Bank's icon catalog
Mobile Prototype
Takeaways
Communication is key
We tried several methods of design hand off, and eventually settled on a two lane hand off stream - Zeplin for business or marketing folks that just wanted a preview, and a Bitbucket based Sketch repo for the developers to see a responsive view of the designs. Once the output streams were settled, there weren't any kinks in the hand off process.
Flexibility is a requirement
There were times when I was coordinating the two different sites - in the EU and North America - where requirements would come down and no one could say where they came from. Often times they were from a EU stakeholder I had never met, but you can't let a little variety ruin your mojo. I worked with stakeholders on calls to make sure that the EU team was satisfied, even if it meant somewhat splintering the designs from each other in the short run.
Good teamwork is essential
Often the blockers on this project were caused by developers trying to be Superman - only to end in sliding schedules. The best results come from Development and UX working in tandem.