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