-
Content design for beta.ada.gov: writing for action and flexibility
on July 13, 2022
We worked with a team at the Department of Justice to redesign ADA.gov. We helped them launch beta.ada.gov, and we’ve designed new content for some of the most sought-after ADA topics.
-
Tech talks with One OHS
on January 25, 2022
Building cross-system interoperability is long-term work, but the tech talks became an early step in establishing shared understandings and contexts for OHS.
-
Content governance: What it is and how to get started
on July 27, 2021
How is your content created and maintained? Who does what? How do you decide what your content priorities are? With content governance you can answer these questions, provide clarity to your organization, and become a content hero!
-
Transforming how DOJ's Civil Rights Division engages with the public
on July 7, 2020
In order to be more responsive to the public’s changing communication needs and the increased reporting volume,the Civil Rights Division, in close collaboration with 18F, has launched a user-friendly online submission experience at civilrights.justice.gov that transforms the way the Division collects, sorts, and responds to civil rights reports.
-
Building trust in a public health crisis
on June 23, 2020
Lately, the 18F content team has been thinking about how to communicate well in a crisis—providing clear, understandable content is especially important. Content strategy practices that focus on the needs of the user are essential to earning the trust of the public. Here, we will explain how to embody those qualities on the web in user-centered ways.
-
Building a collaborative culture: How 18F works
on April 1, 2020
We actively work to help our teammates grow. We want everyone to become better at the work we do, and we want to model that for our partners.All of this requires some key skills: communication, agility, and openness.
-
Ask 18F — How do you tackle the problem of associating plain language to formal governmental terms?
on July 6, 2018
Ask 18F is an advice column that answers questions sent in by federal employees. In this edition, we’ll talk about how to associate plain language to formal governmental terms
-
Writing for the web is easy. Writing for users is not.
on October 26, 2016
Government websites are written for an extraordinarily diverse group of users. They come to our websites with different knowledge, backgrounds, and abilities. Fortunately, there are steps we can take to make sure the content we care about reaches the audience we want (and is useful to them).
-
Strategies for starting your own writing lab
on July 19, 2016
Interested in spinning up your own Writing Lab? Use these tips as your starting point.
-
A conversation about static and dynamic websites
on July 11, 2016
Our blog uses Jekyll, a static file generator with a basic templating system, as the backend software. Deploying our blog posts this way has simplified our publishing process.
-
6 ways a writing lab will help your organization
on June 30, 2016
Wondering if a writing lab might be right for your organization? Reviewing the benefits 18F has seen from our Writing Lab might help you figure out if starting your own is the way to go.
-
Using plain language to bridge the gap between government and industry
on June 21, 2016
Recently, we partnered with the Office of Integrated Technology Services (ITS) here within the General Services Administration (GSA) on a four-month effort to develop a plain language guide, informed by research and interviews, to help technology companies interested in doing business with the federal government better understand how to join IT Schedule 70.
-
Building better by building together with the Federal Election Commission
on June 7, 2016
How do you work iteratively and in the open in government? How do you transform an agency’s digital presence with agile and user-centered design? We’ve learned a lot about this as we’ve worked alongside our partners at the Federal Election Commission (FEC) on beta.fec.gov, and we want to share some of those lessons here.
-
Taking an agile approach to content
on May 31, 2016
At 18F, we work in an agile way — in other words, we base our designs on user needs, conduct usability testing, iterate quickly, and release MVPs (minimum viable products) rather than highly finalized releases. We take an agile approach to content too.
-
The user-centered redesign of IdentityTheft.gov
on May 24, 2016
IdentityTheft.gov is user-friendly and intentional. We talk to the team behind the redesign about the user research that went into content and design decisions for the site.
-
A sestina on sunsetting content
on May 23, 2016
Sunsetting can be contentious in government. We manage websites for the public, which feels like managing content for everyone’s needs. When you have to think about everyone, that makes it a lot more complicated to delete things.
-
Content debt: What it is, where to find it, and how to prevent it in the first place
on May 19, 2016
Like technical debt, a failure to plan for content-related debt can cause major headaches down the road. In this post, I list some potential sources of content-related debt, list ways to identify it, and then share strategies for preventing it in the first place.
-
A guide to the 18F Writing Lab
on April 28, 2016
The guide is designed to equip 18F staff with the information they need to quickly and easily request writing and editing help from the Lab, and also to provide our Lab editors with guidance on editing styles and workflows so we can provide a smooth experience for staff who request the Lab’s help.
-
Lean on me: Asking for help on the content team
on April 25, 2016
Our content squad is made of folks with a wide range of backgrounds and skills — we put this to good use by regularly asking each other for help with projects. Here’s a look into some of our recent collaboration.
-
A clear audience makes for a good blog post
on April 20, 2016
The most important advice I give 18F staff while they’re working on a blog post is to define their audience as clearly and as narrowly as possible. This focus has helped us overcome numerous hurdles to publishing quality blog posts, and it’s also the part of our new Blogging Guide that I’m most excited about.
-
Looking at the different ways to test content
on April 19, 2016
We know good content when we see it, and we’re frustrated when we don’t. Keeping this in mind, are there ways that writers can quantify and measure their writing? We’ve looked at different tests you can run depending on the age of your audience.
-
The teams, they are a changin’
on April 18, 2016
To truly harness the power of agile practices, you need a stable team. But people leave under normal circumstances for a variety of reasons. While recognizing the need for stable teams, there are things our team does and should do to be resilient in the face of change.
-
New guide provides tools for product leads
on March 31, 2016
To help our product managers, newcomers and veterans alike, wear the many hats that their jobs require, we’ve developed the 18F Product Guide. The guide will help get our team on the same page and provide a resource to our newcomers.
-
Tips for capturing the best data from user interviews
on February 9, 2016
User interviews are, at a minimum, an opportunity for you to ask your intended audience about their expectations, what their needs are and to get direct feedback on the work you’ve done so far or on what you plan to do. But an interview is only as good as the data you get out of it.
-
Lending a helping editorial hand: the 18F Writing Lab
on January 22, 2016
The Writing Lab is a virtual writing center where anyone at 18F can get personalized writing and editing help from members of the content and outreach teams.
-
What we can learn from the Interior's social feeds
on January 21, 2016
One of my favorite projects is the U.S. Department of the Interior's work on social media. I recently asked [Jolly Pike]*, the senior digital media strategist for Interior what she’s learned while running an online community that helps Interior achieve its larger strategic goals.
-
Hacking inclusion: How we customized a bot to gently correct people who use the word 'guys'
on January 12, 2016
We want to build a diverse and inclusive workplace where people use more inclusive language so we recently customized Slackbot's autoresponses to respond automatically with different phrases if someone uses the words 'guys' or 'guyz' in an 18F chat room.
-
Turning learning up to 11: Knowledge sharing
on January 5, 2016
The internal knowledge-sharing initiatives we’re working on are also of immediate benefit to other organizations, and will maximize our impact on government IT beyond product delivery.
-
Turning learning up to 11: Transparent internal operations
on January 4, 2016
In the second post in this series on how transparency, autonomy, and collaboration produce organizational culture change, I describe a few of the initiatives we’ve undertaken to increase transparency into 18F’s internal operations.
-
Turning learning up to 11
on December 30, 2015
The feature that distinguishes high-performing organizations across all industries is their ability to facilitate knowledge sharing across the entire organization. This is the first post in a series about the tools and processes we use at 18F to facilitate knowledges sharing.
-
We asked everyone at 18F to reflect on the most meaningful project they worked on this year
on December 23, 2015
2015 was a big year for 18F. We almost doubled in size, worked with 28 different agency partners, and released products ranging from Design Method Cards to cloud.gov. Internally, we improved onboarding and our documentation by releasing guides on topics as diverse as content, accessibility, and creating good open source projects. To mark the end of the year, we reached out to everyone at 18F and asked them to reflect on a meaningful project they worked on this year.
-
Plain language for the win: betaFEC’s new content design
on December 17, 2015
The Federal Election Commission (FEC) has been working since the 1970s to clarify the rules for raising and spending money in federal elections, and today we’re thrilled to announce the first major content launch of betaFEC: a guide to registration and reporting that makes intricate information easier to understand.
-
How a bot named Dolores Landingham transformed 18F’s onboarding
on December 15, 2015
Over the past few months, we’ve released several products — including checklists, a handbook, and classes — to help new hires orient themselves to 18F. By far the most successful onboarding item we’ve released is a Slack bot that sends scheduled messages to new hires so that they don’t experience information overload during their first week.
-
How we test 18f.gsa.gov
on December 11, 2015
As our blog got more complicated, we started making mistakes that were hard to catch before publishing. So we came up with a way to catch many of those errors, before they end up in your browser.
-
Using emoji for knowledge sharing
on December 8, 2015
Our coworkers are very, very good at documenting the things they learn in Slack, our chat program, because it’s part of their daily workflow. So I tried an experiment: I asked my 18F coworkers to tag messages that every new 18F employee should know with the :evergreen_tree: emoji.
-
How we dramatically improved 18F’s onboarding process in 3 months
on December 1, 2015
Over the past three months, we’ve released several products that help new hires acclimate to our organization. In this blog post, we’ll detail what we did and why it works really well.
-
How we use a lean approach to product design
on November 20, 2015
Here at 18F, several product teams (including CALC, Discovery, and EITI) have been experimenting with a lean product design approach to building software, often called “lean UX.” In a nutshell, it is a set of ideas about design and project management that help us focus not just on what we build, but on the outcomes our tools enable.
-
In conversation with CFPB’s [Sweet Thrush]*
on November 6, 2015
Last month, content strategist and UX designer [Sweet Thrush]* from the Consumer Financial Protection Bureau presented at 18F. Prior to her presentation, we had the chance to chat with [Thrush]* via email about her experience working with different types of content, her predictions for the field, and the collaborative approaches she recommends.
-
Content strategy for all: insights from CFPB’s [Sweet Thrush]*
on November 3, 2015
[Sweet Thrush]*, a content strategist at the Consumer Financial Protection Bureau, recently spoke at 18F about some best practices for creating and promoting digestible, user-friendly content.
-
18F’s best practices for making distributed teams work
on October 15, 2015
18F employees live all over the country, which means it's normal for the members of a project team to be spread across multiple cities. Because our teams are distributed, we've developed certain strategies for working well as a collaborative operation.
-
What's in a name: Understanding and using government acronyms
on October 14, 2015
We have an acronyms section in our Content Guide, a resource we heartily recommend. Acronyms and abbreviations also have a ton of associated history and nuance, which we’re shedding light on here, hopefully to encourage other authors and agencies to think carefully about how they use them in digital tools.
-
You shared, we listened — updates to the 18F Content Guide
on October 8, 2015
After we launched the 18F Content Guide, we received all kinds of suggestions for updates and improvements. Here's a sampling of some of the improvements we've made recently based on your suggestions.
-
18F’s style guide for open source project documentation
on July 29, 2015
The Open Source Style Guide is a comprehensive handbook for writing clear, accessible, and user-friendly documentation so that your open source code repositories are accessible both internally and externally.
-
The 18F content guide: working toward cleaner, more accessible communication
on July 6, 2015
We’re proud to announce the release of our 18F Content Guide, a comprehensive handbook to help content creators on our team (and, we hope, elsewhere) create more direct, accessible, and compelling written works.
-
Building a better welcome wagon
on June 15, 2015
As our team expands to meet federal digital needs, we've learned to appreciate documentation for its ability to turn new hires into self-sufficient contributors quickly, with minimal disruption to the organization.
-
Giving back to open source: Everybody wins
on June 3, 2015
We love when we're able to contribure to open source projects from other organizations. Recently, we contributed to Bitly's open source google_auth_proxy to support our Hub and MyUSA applications, and our contribution has already helped other OAuth2 providers.
-
18F Guides
on May 28, 2015
While there's no substitute for personal instruction and mentorship, that effort scales far more effectively when there are clear, concise materials to introduce the basics. 18F Guides aims to fill that role for our young and growing team, and we hope it may be of use to others as well.
-
Tocking time
on May 21, 2015
I recently spent time helping with one of our internal frustrations — how members of 18F track how we spend our time. Ultimately, we opted to try rolling our own simple solution using Django: Tock.
-
18F: a great place to write
on April 29, 2015
We collaborate on much of what we do at 18F, from the way we work on code to the way we write our blog. Though we have a small editorial team, the blog — and our writing process — extends ownership to the entire 18F team.
-
Making Twitter images accessible
on March 24, 2015
To make our tweets more accessible, 18F has started responding to our Tweets containing images, with another tweet explaining what the image shows.
-
A day in the life of an 18F content designer
on March 12, 2015
In preparation for our one-year anniversary, we at 18F are introducing a new blog feature — our Day in the Life Series. Once a month, a different team member will share the details of their typical day in the office. Up first is a content designer.
-
How to use GitHub and the terminal: a guide
on March 3, 2015
At 18F we hire people from many different backgrounds and each new employee brings a different level of comfort with the specific tools we use on our various projects. The team that runs the 18F website recently started writing down the tools and processes that we use to update the blog and the code that runs the site. We're sharing that with you today.
-
Three 18F products that will help your workplace
on February 17, 2015
I’ve worked at 18F for exactly six days. During those six days, I learned about a few products that I wish I’d known about while at my previous job. These products would not only have saved me hours of work (itself a bonus), but they also would have fostered long-term collaboration.
-
The 18F Hub
on December 23, 2014
The Hub is a Jekyll-based documentation platform that aims to help development teams organize and easily share their information, and to enable easy exploration of the connections between team members, projects, and skill sets. It also serves as a lightweight tool that other teams can experiment with and deploy with a minimum of setup.
-
Snippets
on December 17, 2014
18F has begun collecting and publishing team member "snippets," short lists summarizing what you worked on the previous week and what you plan to work on during the upcoming week. Team members submit their snippets each Monday, and they are published internally for all to peruse. Snippets foster transparency and team cohesion, spark productive interactions, and can be cultivated right away using tools already at-hand.
-
Taking control of our website with Jekyll and webhooks
on November 17, 2014
How we moved our website to Jekyll, left Tumblr behind, and set up automatic deployment with webhooks.
Back to
18F Blog