Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/18F/ux-guide

Resources, norms, and practices for doing user experience research and design work at 18F.
https://github.com/18F/ux-guide

18f ux ux-research

Last synced: 3 months ago
JSON representation

Resources, norms, and practices for doing user experience research and design work at 18F.

Awesome Lists containing this project

README

        

**⚠️ This guide has moved to the [consolidated 18F guides repository](https://github.com/18F/guides).**

# 18F UX Guide

18F user experience (UX) designers join cross-functional teams to
collaboratively improve user experiences across government. This guide is here
to help us get the job done. It’s neither a step-by-step tutorial nor a set of
rules. Instead, it’s a starting point for 18F-led UX design: doing it,
discussing it, and ensuring it’s done to a consistent level of quality. This
guide is iterative and you can review
[our goals](https://github.com/18F/ux-guide/wiki/Goals),
[contribute](https://github.com/18F/ux-guide/blob/main/CONTRIBUTING.md) or get a
general overview below.

---

## Table of contents

1. [About](https://github.com/18F/ux-guide/blob/main/_pages/about.md)
1. Our approach
1. [Values and principles](https://github.com/18F/ux-guide/blob/main/_pages/our-approach/values-and-principles.md)
1. [Defining design](https://github.com/18F/ux-guide/blob/main/_pages/our-approach/defining-design.md)
1. [Stay lean](https://github.com/18F/ux-guide/blob/main/_pages/our-approach/stay-lean.md)
1. [Meet partners where they are](https://github.com/18F/ux-guide/blob/main/_pages/our-approach/meet-people-where-they-are.md)
1. Research
1. [Clarify the basics](https://github.com/18F/ux-guide/blob/main/_pages/research/clarify-the-basics.md)
1. [Plan](https://github.com/18F/ux-guide/blob/main/_pages/research/plan.md)
1. [Do](https://github.com/18F/ux-guide/blob/main/_pages/research/do.md)
1. [Make research actionable](https://github.com/18F/ux-guide/blob/main/_pages/research/make-research-actionable.md)
1. [Legal](https://github.com/18F/ux-guide/blob/main/_pages/research/legal.md)
1. [Privacy](https://github.com/18F/ux-guide/blob/main/_pages/research/privacy.md)
1. [Bias](https://github.com/18F/ux-guide/blob/main/_pages/research/bias.md)
1. [Ethics](https://github.com/18F/ux-guide/blob/main/_pages/research/ethics.md)
1. Design
1. [Build a prototype](https://github.com/18F/ux-guide/blob/main/_pages/design/build-a-prototype.md)
1. [Use a design system](https://github.com/18F/ux-guide/blob/main/_pages/design/use-a-design-system.md)
1. Resources

## Development
The UX Guide uses [USWDS-Jekyll](https://github.com/18F/uswds-jekyll).

### Build

To build locally using Docker (recommended):

1. Install [Docker for Mac](https://docs.docker.com/desktop/install/mac-install/)
1. Clone this repository
1. From this repository's root directory, run `docker-compose up --build`
1. Open http://localhost:4000

Or, build locally without Docker:

1. Clone this repository
1. Install [Jekyll](http://jekyllrb.com/) and the necessary dependencies by running `bundle install`
1. Run the web server: `bundle exec jekyll serve`
1. Open http://localhost:4000

---

## Contributors

This guide was collaboratively authored by members of 18F’s UX team past and present. While the initial content was pulled together over a few months, the guide builds on institutional knowledge from across 18F over the years. The following are the original members of the UX guide working group:

- Qituwra Anderson
- Melissa Braxton
- Jeremy Canfield
- Jennifer Damis
- Matt Dobson
- Vishal Iyer
- John Donmoyer
- Nikki Lee
- Julia Lindpaintner
- Corey Mahoney
- Andrew Maier
- Anne Petersen
- Ben Peterson
- Jacklynn Pham
- Laura Poncé
- Aditi Rao
- Mark Trammell