Skip to content
This repository was archived by the owner on May 31, 2024. It is now read-only.

18F/methods

Folders and files

NameName
Last commit message
Last commit date
Mar 23, 2023
Apr 7, 2023
Apr 10, 2023
Apr 7, 2023
Apr 11, 2023
Sep 22, 2023
May 31, 2023
Apr 11, 2023
Apr 7, 2023
Apr 7, 2023
Apr 11, 2023
Feb 4, 2016
Mar 10, 2023
Apr 7, 2023
Mar 6, 2023
Feb 7, 2023
Dec 6, 2022
Mar 10, 2023
Sep 22, 2023
Jan 8, 2018
May 22, 2017
May 15, 2020
Oct 20, 2022
May 31, 2024
May 22, 2017
Mar 10, 2023
Dec 6, 2022
Feb 17, 2023

Repository files navigation

⚠️ This guide has moved to the consolidated 18F guides repository.

Methods

The 18F Methods were created to describe how 18F puts human-centered design into practice. While this was developed primarily as an internal resource, we hope it can help everyone adopt the methods of human-centered design.

Why methods?

In order to function well within cross-functional teams, designers and other contributors need to know a few things: which methods they might choose from, why one particular method makes more sense than another at any given moment, and, once they’ve picked a method, how to actually execute it. 18F Methods collects this essential information as a series of cards. In practice, we’ve found the Methods can provide folks with a gateway into our work and build internal alignment around a shared vocabulary.

Specific to 18F, specific to the federal government

It’s important to note that the 18F Methods are designed to account for two things that may not otherwise concern a more generic collection of design methods. First, these methods directly reflect and support 18F’s human-centered work. (They are also continuously updated in a human-centered way — how meta!) Second, 18F Methods are designed to keep federal employees on the happy side of the law. This collection specifically includes helpful information which designers working in the federal government may need, such as privacy and the Paperwork Reduction Act.

Getting started

Reading the Methods online

You’re presently looking at the Methods’ GitHub (code) repository. Please visit our homepage to read the Methods online.

Printing the Methods

To print a copy of the Methods for offline use, visit the Methods print page. You may need to select file → print… from your web browser.

Contributing to the Methods

For more information on contributing to the Methods (or even making a suggestion), see CONTRIBUTING.md. If you would like to suggest a new Method be added to the collection, please follow the instructions here.

Learn more about our goals and the way we work in our wiki.

Development

Running the Methods website on your local machine

Using Docker (recommended)

  1. Install Docker for Mac
  2. Clone this repository
  3. From this repository's root directory, run docker-compose up --build
  4. Open http://localhost:4000

Without Docker

You will need Ruby ( > version 2.1.5 ). You may consider using a Ruby version manager such as rbenv or rvm to help ensure that Ruby version upgrades don’t mean all your gems will need to be rebuilt.

On OS X, you can use Homebrew to install Ruby in /usr/local/bin, which may require you to update your $PATH environment variable:

$ brew update
$ brew install ruby

To serve 18F Methods locally, using methods as the name of your new repository: Run each of the following steps to get the site up and running.

$ git clone [email protected]:18F/methods
$ cd methods
$ bundle install
$ jekyll serve

You should be able to see the site at: http://localhost:4000/

Deploying

The Methods guide uses a webhook to deploy to Cloud.gov pages. When viewing a pull request, expand "Show all checks." If pages/build is complete, click "details" for a link to a preview for that branch.

Current product owner

  • Melissa Braxton

Past contributors

  • Tiffany Andrews
  • Carly Jugler
  • Megan Reed
  • Peter Rowland
  • Julie Strothman
  • Anne Petersen
  • Amirah Aziz
  • Ana Monroe
  • Jeremy Canfield
  • Elisa Chen
  • Erica Deahl
  • Carolyn Dew
  • Matt Dobson
  • Andre Francisco
  • Leah Gitter
  • James Hupp
  • Nicky Krause
  • Omid Ghaffari-Tabrizi
  • Julia Lindpaintner
  • Colin MacArthur
  • Andrew Maier
  • Brad Nunnally
  • Eric Richards
  • Eric Ronne
  • Jennifer Thibault
  • Russ Unger
  • Scott Weber
  • Victor Zapanta

Public domain

This project is in the worldwide public domain. As stated in CONTRIBUTING:

This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.

All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.