Skip to main content

An Upgraded Experience with Drupal 10

Description
We upgraded 8 sites to Drupal 10 for the Centers for Medicare and Medicaid Services (CMS) ahead of deadline.
Teaser Image
Image
Photo of hands typing on a laptop beside a toy ambulance and stethoscope.
Body

CivicActions, along with our partner Fearless, facilitated Drupal 10 upgrades across the Centers for Medicare and Medicaid Services (CMS) suite of websites, bringing improvements for editors, better security and accessibility, and community contributions to streamline upgrades for large- scale Drupal. The new Claro administration theme is cleaner, clearer, and more accessible.

The new rich text editor CKEditor 5 provides many UI enhancements and an improved user experience. The most significant change from previous versions of CKEditor is that editors must now use a predefined set of elements to configure the content, which leads to fewer instances of invalid markup patterns making their way into the published site. Since invalid or non-semantic markup is often the cause of accessibility issues, this is a major upgrade. In addition, the improved Layout Builder experience makes it easier for content editors to control more complex layouts, while still keeping consistent with CMS Design System standards.

The 8 sites included in the upgrade, which occurred ahead of schedule, were: CMS.gov; Medicare.gov; Openpaymentsdata.cms.gov; Data.medicaid.gov; Data.healthcare.gov; SDIS.medicaid.gov (internal CMS site); PFS.data.cms.gov (internal CMS site); QIC.cms.gov (internal CMS site); and Provider Data Catalog (data.cms.gov/provider-data).

Outcomes

More Accessible Experience

The new Claro administration theme is cleaner, clearer, and more accessible. In addition, the shift to CKEditor5 decreases accessibility errors from invalid markup.


 

Better User Interface for Editors

The improved Layout Builder experience makes it easier for content editors to control more complex layouts, while still keeping consistent with CMS Design System standards.


 

Improved Human-Centered Design

Drupal 10’s new rich text editor CKEditor 5 provides many UI enhancements and an improved user experience.


 

Better than On Time

This work was completed before the deadline and included upgrades on eight websites for CMS, meaning more improvements sooner.


 

Improved Security

Drupal 10’s upgraded Symfony 6 allows for increased security, so site users can feel secure that their data is private.


 

Seamless Transition

With zero downtime during upgrades, this work was swiftly executed with a seamless transition to Drupal 10.


 

Proof points
Value
600
Description

CMS.gov editors

Value
0
Description

Downtime during upgrades

Value
8
Description

Sites upgraded

Modernizing and Streamlining Cybersecurity Information

Description
We worked alongside ISPG customers and stakeholders to design and build a searchable, user-friendly portal for cybersecurity information – making it easier for security personnel to keep CMS data and systems safe.
Teaser Image
Image
Glowing cyan circuit board schematic on a futuristic digital display.
Team members
Body

The challenge

The CMS Information Security and Privacy Group (ISPG) is in charge of the policies and programs that ensure the security and privacy of data that is handled by CMS information systems. ISPG staff and contractors work to maintain policies, distribute guidance, communicate with customers, support security programs, and promote new initiatives.

While doing this important work over the years, they amassed a large collection of documents and resources that were spread across various locations and formats. This led to issues with version control and made it hard for people to find the information needed to do their security-related tasks.

Without a single, trusted location for cybersecurity information – and with many of the documents being in static PDFs that were full of jargon and hard to understand – finding essential information from ISPG could be onerous, negatively impacting CMS’ overall security posture.

Client goal

To improve their customer service and promote better security across CMS systems, ISPG engaged our team to develop a user-friendly website (informally known as “CyberGeek”) at security.cms.gov that is recognized as the authoritative home for CMS security and privacy information. With this project, ISPG aims to:

  • Improve customer service through modern information delivery
  • Support CMS security personnel with the resources needed for their critical work
  • Make security topics and policies more approachable and human-centered
  • Build user-friendly processes to help ISPG staff maintain their content
  • Establish a platform where customers can find news and updates from ISPG

Our Approach

Together with our partner Affix Digital, we worked closely with ISPG stakeholders and customers to understand the cybersecurity ecosystem at CMS. We built relationships across ISPG and partnered with their leadership and program teams to streamline their content into a single, trusted platform that makes cybersecurity information approachable and human-centered.

First, listen and learn

We started by interviewing ISPG customers to make sure we built the site’s information architecture in a way that made sense to the people using it. Card sorting – a process that involves users in the design of the site navigation – helped solidify the menus and categories that would be the foundation of a user’s journey through the site.

Open source and accessible

We built a decoupled site using Drupal and React to give the client flexibility for technology changes in the future. Utilizing the U.S. Web Design System (USWDS), we created a component library that ensures the site meets government requirements for things like accessibility and mobile responsiveness. We used Storybook to build components in isolation before deployment to the site, catching errors in real-time so they could be fixed on the spot.

Search at the core

One of the main problems ISPG wanted to solve for their customers was the headache of searching for security documents, templates, and program information – which had been difficult to find in various internal repositories. We implemented a powerful search feature using Algolia, with filter options to help people find information specific to their needs. Improvements to search are ongoing as we learn more about how people use it.

Outcomes

Improved customer experience

From Information System Security Officers (ISSOs) to Business and System Owners, the new website provides a better experience for people who need to interact with ISPG as part of the security compliance process at CMS.


 

Searchable and intuitive site

User and stakeholder interviews revealed that ISPG customers are loving the website’s powerful search feature, intuitive navigation, and clean design. Cybersecurity staff can focus on their work without wasting time hunting for information.


 

Accessible & approachable policy guidance

Complex security policies and processes are easier to understand now that ISPG’s guidance documents are written in plain language, with user needs and accessibility best practices at the forefront.


 

Simple content management

ISPG staff can access the pages they are responsible for managing through a user-friendly content management interface in Drupal. The workflows are designed to support busy staff and reduce content publishing bottlenecks.


 

Trusted communication channel

ISPG staff had struggled to communicate critical program updates effectively across many different platforms. The blog on their new website streamlines messaging into one trusted channel.


 

Ongoing partnership

To ensure the ongoing success of the ISPG website, we engaged deeply with ISPG teams all along the way, helping them evolve their organizational processes and sharing best practices for modern web content management.


 

Proof points
Value
95%
Description

of ISPG’s static PDF documents converted to accessible HTML content

Value
240+
Description

CMS systems protected by ISPG’s security policies & programs

Value
1
Description

trusted source for CMS security and privacy information

Better Accessibility Through Alternative Text Validation

Description
We updated VA.gov based on user research to create better alternative (alt) text in order to provide a more accessible experience for Veterans.
Teaser Image
Image
Photo of coworkers using laptops at a shared desk.
Body

The challenge

Alternative text is a complex topic, as it is difficult to account for every possible scenario or to provide sufficient context for each image. However, in order for web pages to be the most accessible, any contextual images that have been added must include good quality, descriptive alt text. Our team was tasked with updating the image upload editorial interface within Drupal to help editors add better, more useful alt text for the images they were uploading.

We completed a full, cross-disciplinary project with our partners Friends From The City and Agile Six. The project included discovery to determine exactly which areas would be best to focus on, building a functional prototype for user research, and ultimately implementing improvements determined from that research to create a better, more informed user interface for Drupal editors.

Client goal

Our goal was to create a better alt text experience for Veterans visiting VA.gov. To achieve this we had to improve the user interface within Drupal to:

  • Streamline and simplify the image upload form
  • Clearly identify the alternative text field
  • Add client-side validation for common errors seen within existing alt text
  • Provide clear and concise error messages for editors to correct mistakes
  • Educate editors on how to create descriptive and accurate alt text and why it is important

Building on Drupal, an open-source content management system (CMS), we wanted to improve the image upload editorial interface by implementing guardrails to prevent poor quality alt text through the enforcement of accessibility best practices while also reducing frustrations for CMS editors who are writing the alt text - ultimately resulting in better quality alternative text for people who rely on it to access visual content on VA.gov.

Our team worked cross functionally with our partners to explore solutions that were not only technically feasible, but also solved a variety of user needs by following human centered design practices. Research was a key component to improving the alt text on VA.gov, from gathering and analyzing statistics on current alt text to conducting user research sessions. The final design that was implemented was a direct result of iteration based on user feedback and thought partnership with our team and the product owners at the VA.

Determine which metrics to target

The current alt text for images within Drupal was evaluated based on multiple criteria - did the alt text contain a filename; was the alt text concise; was the alt text redundant; was the alt text accurate. The last criterion is very contextual, however the first three are more subjective and we decided to target those metrics to start focusing our improvements.

Identify Improvements

We created an interactive prototype to test with users. We analyzed the feedback from those research sessions to determine the best way to incorporate validation into the alt text field with the least amount of user disruption. We also determined additional user interface updates that would make the entire image upload experience a simpler and easier task for the editor.

Educate Drupal Editors

We created training articles within the Drupal Knowledge Base to help editors contextualize alt text and more fully understand what it is and why it is important. By helping editors understand the experience a Veteran might have if an image they upload has poor alt text, they will better understand the content they need to provide to improve this experience.

Outcomes

Research-based design

We conducted research with VA.gov Drupal CMS editors to gather real data about how they upload images and interact with the alt text field. This data informed our final design decisions.


 

Improved editor interface

Our research found other improvements that could be made to the image upload user interface. These were small updates but resulted in a large impact to editors and greatly reduced confusion and frustration.


 

Immediate feedback

We added client-side validation to the alt text field, providing feedback to editors immediately when an error occurs.


 

Targeted training materials

Education is a large part of making accessible content. We provided resources for editors to help them understand the importance of alt text, with examples that can help them create better content for people who may have a visual disability.


 

Scalability

The introduction of client-side validation allows for the expansion of this feature to other input fields of the Drupal CMS with similar content quality issues.


 

Accessible information

VA.gov site visitors all deserve to access the information within the website. Providing better alt text allows the visual information in images to be available to those who may rely on a screen reader.


 

Proof points
Value
1053
Description

Drupal Editors

Value
573
Description

Images uploaded per month (6 month average)

Value
6
Description

Mistakes prevented daily

Building an MVP for Medicare.gov with human-centered design

Description
We did a fast-paced collaboration to submit deliverables in just 8 days, winning the design challenge to help CMS improve the customer experience of their websites.
Teaser Image
Image
Smiling older couple sitting together and looking at a laptop.
Body

The challenge

The Centers for Medicare & Medicaid Services (CMS) help millions of people every year find and enroll in health care programs. Planning a large-scale web and content management project to improve the customer experience of their multiple websites, the agency launched a design challenge for the vendors that were finalists for the contract.

We did a fast-paced collaboration with our partners Fearless and KPMG to submit deliverables in just 8 business days (including page designs, content recommendations, an API, and a clickable prototype with a smart chatbot). Our team won the challenge because the agency saw we could help them achieve their goal to better serve Medicare beneficiaries.

Client goal

The task was to redesign the Medicare Part D section of the medicare.gov website, which helps people understand insurance options for their medication needs. For all their digital platforms, CMS needs to:

  • Meet public expectation for easily navigable online services
  • Securely manage personal info and transactions for millions of beneficiaries
  • Provide friendly online experience for people facing stressful health situations
  • Serve diverse groups of users with competing wants and priorities
  • Support agency staff in publishing clear and accurate public-facing content

Our approach

Within the time constraint for this compressed agile design sprint, we conducted lean versions of the activities we would normally do to make sure the site was effective for Medicare recipients. Daily collaboration among all team members, from Design to DevOps to Developers, allowed us to quickly test and iterate on every step.

We used Drupal as our preferred open source platform and the CMS design system, which builds on the U.S. Web Design System. Together, these tools provide a solid foundation for accessible government websites — a key goal for agencies like CMS that serve diverse and aging populations.

Human Centered Design played a critical role in our process of building a site that would be intuitive and useful to older Americans seeking information about their drug coverage options.

Understand the needs

We talked to real Medicare beneficiaries to understand the challenges they faced in navigating the site. Based on what they said, we created a key persona to drive our scenario-based approach — ensuring that our work solved real problems and created value for users. We also evaluated the existing site to see how well it met standards for usability.

Offer customized guidance

To help visitors feel comfortable navigating complex information about benefits coverage, we created several experience options for them to choose from. They could explore the site on their own, use the guidance wizard, or ask questions of the interactive chat bot. We also improved the Search function to deliver more relevant results.

Clear the path to success

We focused on removing obstacles to help more people successfully find the information they needed. This was done through intuitive navigation and labels, scannable and actionable content, and a refreshed, accessible design. We tested our solutions with users and iterated based on their feedback.

Outcomes

Research-based solution

Because we spoke to Medicare recipients and validated our proposed solutions with them, CMS knows that real user needs will be met with the redesigned site, helping people access benefits more easily.


 

Consistent online experience

Medicare.gov visitors deserve a consistent experience across all parts of the site, on any device. Our design uses a mobile-first approach and a color palette that provides smooth transitions between pages.


 

Accessible healthcare services

The prototype is compliant with Section 508, using intuitive design and clear language to make complex medical insurance information easily accessible by the broadest possible representation of the public.


 

Data to help others

Doctors, app developers, health information curators, and others can pull valuable Medicare data for their own use through the API integration we created using the JSON:API that is part of Drupal core.


 

Simplified content management

The prototype showed how CMS staff can more easily get the right information to the right people using templates and workflows in Drupal, customized for the agency’s various departments and content needs.


 

Efficient and reliable technology

We built the prototype using the same Agile and DevOps practices that we would on a larger scale — with streamlined workflows that allow us to build, test, and deploy new code quickly and securely.

 


 

Proof points
Value
45 M
Description

Americans using this Medicare service

Value
8
Description

days to complete MVP redesign

Value
4
Description

steps in simplified application process

Improving the online experience for Medicare beneficiaries with WECMS

Description
We are working to re-platform and redesign legacy systems for CMS, making it easier for millions of people to get the benefits they need.
Teaser Image
Image
Photo of a smiling girl holding flowers beside her grandfather outdoors.
Body

The challenge

The Centers for Medicare and Medicaid Services (CMS) provide healthcare benefits to millions of people every year. But the websites and digital tools that help people find and enroll in these programs were built on a myriad of aging technologies and were confusing to navigate. CMS needed to streamline and update its online platforms to improve the customer experience while establishing more efficient backend workflows for agency staff.

This is an enormous and complex task, involving the modernization of Medicare.gov, CMS.gov, CMS open data portals, and many other public facing apps that serve multiple user groups — including beneficiaries, caregivers, health providers, data professionals, and government stakeholders.

WECMS helps more than 100 million Americans every year apply, find, and enroll in healthcare programs. The information and tools provided are essential components in supporting CMS' goals of creating a truly consumer-focused, streamlined, efficient, and omni-channel experience for beneficiaries and their caregivers. The overall intent for this contract is to ensure continuity of operations for the Americans it serves and the WECMS program, which maintains, designs and implements open source software digital services for CMS’ flagship websites, tools, components and applications on Healthcare.gov, Medicare.gov, CMS.gov, and 7 Open Data catalogs. In addition to engineering and design continuous improvements on these established websites, this contract provides security compliance, devops, system infrastructure, content strategy, information architecture, training, documentation, content editor support, public call center dev support, Section 508 improvements, mobile application development, and tooling and systems expertise.

Client goal

When this multi-year transformation is complete, CMS will be able to deliver on its mission more effectively. CivicActions is providing agile development, DevOps, and human-centered design (HCD) services to help the agency:

  • Improve the content editing experience for staff
  • Modernize legacy systems and tools
  • Replace proprietary technologies with open source
  • Support active, informed healthcare consumption

Our approach

Collaboration is the key to success in a project of this scale and complexity. With multiple partner vendors (including our primary partner Fearless) and disparate stakeholders across many organizational layers, we work hard to keep lines of communication open and be up-front about potential problems.

Balancing stakeholder priorities, user needs, technical complexity, and CMS deadlines, we created a roadmap that minimizes risk and maximizes opportunities for success. Then we went to work on “quick wins” — tasks we could complete right away that would make the biggest difference for users.

Address the holistic customer experience

We knew that each CMS application is part of a huge public-facing ecosystem of digital tools, with many touchpoints. To address the entire experience that a person would have in navigating the systems, we drew on the agency’s own knowledge of their beneficiary community, working with them to refine and document how each person interacts with CMS online. The resulting holistic view helped us identify how we could improve that experience iteratively.

Adopt a data-driven strategy

To make sure we built the right solutions, we immersed ourselves in the CMS mission from the operational, technical, and UX perspectives. We dug into existing user research, reviewed analytics reports, conducted stakeholder interviews — then created user personas and journey maps to refine the project scope and goals. All this data is managed in a shared repository of user insights and project knowledge, which we refer to as we prioritize the work to be done.

Replace proprietary software with open source

We are “reverse engineering” multiple custom-built Microsoft.NET applications (such as the Medicare Eligibility and Premium Calculator and the congressionally-funded Physician Fee Schedule (PFS) Lookup Tool with modern, open source solutions. As we recreate all these applications in Drupal, we’re making guides and code documentation that outline the entire system — allowing CMS to maintain control of its own technologies and avoid vendor lock-in. We are also migrating CMS open data platforms from Socrata (proprietary) to an open source solution using DKAN 2.

Outcomes

Clean and useful technology

CMS struggled to make use of technologies built on old, messy code that had been around for years. We are not only modernizing the CMS tech stack, we are documenting how it works and how to use it.


 

Accessible services for all

508 compliance is required, but we consider accessibility as more than a checkbox. Because CMS serves a population with a proportionately higher level of impairments, we put extra emphasis on accessibility best practices.


 

Agile delivery at scale

We are managing this project using the Scaled Agile Framework (SAFe), working iteratively with broad cross-team collaboration and stakeholder input across the organization. Value is delivered with releases every two weeks.


 

Intuitive digital tools

Beyond CMS websites, we are modernizing cost calculators, finders, mobile apps, interactive map models, open data site applications, and lookup tools that are used by providers and beneficiaries to perform critical healthcare tasks.


 

Well-informed solution

We apply human-centered design to understand the goals of end users and CMS stakeholders, while layering in a thorough understanding of the policies that underpin each program — so the end results meet real needs.


 

Ongoing technical support

To improve and maintain the CMS systems, we provide 24x7 operations and maintenance support, editor feature enhancements, guidance content and APIs per executive orders, and new content sections as needed.


 

Proof points
Value
100 M
Description

Americans depend on CMS for health benefits

Value
10
Description

legacy applications migrated and rebuilt in Drupal

Value
24x7
Description

O&M support provided to critical healthcare systems

A smoother path to scientific research and discovery

Description
Using human-centered design and the latest Drupal technology, we helped NSF build a dynamic website to advance their mission.
Teaser Image
Image
Two scientists in safety glasses examine colorful test tubes in a lab.
Body

The challenge

The National Science Foundation (NSF) is an independent federal agency created by Congress in 1950 to “promote the progress of science” and “advance the national health, prosperity, and welfare." With a 2021 budget of $8.5 billion, NSF accounts for over 25 percent of the total research funds awarded at U.S. colleges and universities.

CivicActions was tasked with rebuilding the entire public-facing NSF website, including implementation of all new visuals and improvement of the information architecture. By collaborating closely with stakeholders across NSF and adopting a rapid-iteration MVP approach, we regularly released prioritized features while simultaneously building the back-end infrastructure to power the ongoing full-scale migration.

Client goal

To better serve employees and the scientific community — including researchers in mathematics, computer science, social sciences, and beyond — NSF needed to replace the existing NSF.gov with a modern, flexible, cloud-hosted online experience. Primary goals were to:

  • Modernize and improve the user experience for nsf.gov
  • Improve funding search for colleges, researchers, and scientists
  • Empower NSF staff with a new Content Management System (CMS)
  • Leverage user research and testing throughout the project

Our approach

To support timelines for a public launch, we took an “MVP approach” by launching a beta site with a small, prioritized set of functionalities. As new pages and features are built, the site continues to develop over time, in the open. This approach requires rapid prototyping and iteration, frequent testing, and continuous engagement with stakeholders.

Start by understanding the needs

After some initial design discovery, NSF engaged CivicActions in September of 2018 to begin a site-wide redesign and migration. The legacy NSF.gov site — built mostly in static HTML — was hard to manage and laborious to update. We knew a scalable, flexible CMS solution was needed, so we got right to work on development and design — starting the site infrastructure, building the initial set of components, and kicking off design research.

Identifying “top tasks” of various user groups helps us solve the right problems for people.

Deliver fast and improve continually

By the spring of 2019, we’d launched beta.nsf.gov and established an iterative, MVP-based approach that allowed our design and development team to release and test content with static data while continuing to build out the site infrastructure. Later that year, we released an updated Careers portal on https://beta.nsf.gov/careers, and began research on the Funding portal and the Funding Search feature.

Improve organizational processes

Working closely with NSF stakeholders, we continued to steadily test and release features, launching the Science Matters blog and an updated top level menu in February 2020. By the fall, we integrated the Pims Rest API to streamline NSF’s online program management, and deployed the Drupal Layout Builder tool that allows content editors to drag and drop content as they build and publish pages.

Partnership for public good

In 2021, after extensive research, testing and iteration, the updated Funding Search Portal will be launched in June — creating a simpler, quicker way to fund the research that powers the U.S. scientific community. Additionally that year, CivicActions was awarded a $44 million contract extension to continue supporting this important work. As we look to the future with a growing team and ambitious goals, we are grateful for our ongoing partnership with NSF.

Outcomes

Fast delivery of value

Our “MVP approach” helped NSF launch their new site sooner, with ongoing improvements being made in the open. Public feedback is welcome along the way.

Ongoing Drupal upgrades

As we continue to migrate the site, we will scan all modules for deprecated code, contribute patches to Drupal.org, refactor theming for Twig 2 compatibility, and perform core updates to Drupal 9.x.


 

Automated testing

To check the updated codebase for failures and disrupted user paths, we run automated tests including accessibility scanners, security, unit testing, behavioral testing, and code quality.


 

Confident deployments

Through 73 sprints, 2,000 deployments, and over 2,000 Jira tickets, the abundance of automation and testing gives us confidence in our code.


 

Research-based solution

Because NSF invested in broad user research and testing, they can be confident that their new site meets the real needs of the scientific community and the organization stakeholders.


 

Taxpayer savings

The intuitive new content management system allows NSF staff to publish and update helpful information quickly and easily. The time they’re saving can be reinvested into other mission-critical work.


 

Proof points
Value
25
Description

stakeholder design review cycles

Value
350+
Description

user research participants from over 60 organizations

Value
2,000+
Description

deployments and completed Jira tickets