Simpler.Grants.gov Public Wiki
Grants.govSimpler.Grants.govGitHubDiscourse
  • 👋Welcome
  • GET INVOLVED
    • Why open source?
    • How to contribute code
    • How to file issues
      • Report a bug
      • Request a feature
      • Report a security vulnerability
    • Community guidelines
      • Code of Conduct
      • Reporting and removing content
      • Incident response protocol
    • Community events
      • Fall 2024 Coding Challenge
        • Event Submissions & Winners
      • Spring 2025 Collaborative Coding Challenge
        • Event Submissions & Winners
    • Communication channels
  • Product
    • Roadmap
    • Deliverables
      • 🏁Static site soft launch
      • 🏁Static site public launch
      • 🏁GET Opportunities
      • 🏁Open source onboarding
      • 🏁Co-Design Group planning
    • Decisions
      • ADR Template
      • ADRs
        • Dedicated Forum for Simpler.Grants.gov Community
        • Recording Architecture Decisions
        • Task Runner for the CI / CD Pipeline
        • API Language
        • Use Figma for design prototyping
        • ADR: Chat
        • DB Choices
        • API Framework and Libraries
        • Back-end Code Quality Tools
        • Front-end Language
        • Communications Tooling: Wiki Platform
        • Use Mural for design diagrams and whiteboarding
        • Ticket Tracking
        • Front-end Framework
        • Front-end Code Quality Tools
        • Front-end Testing & Coverage
        • Backend API Type
        • Front-end Testing & Coverage
        • Deployment Strategy
        • Use U.S. Web Design System for components and utility classes
        • FE server rendering
        • Use NPM over Yarn Architectural Decision Records
        • U.S. Web Design System in React
        • Communications Tooling: Video Conferencing
        • Back-end Production Server
        • Communications Tooling: Analytics Platform
        • Commit and Branch Conventions and Release Workflow
        • Cloud Platform to Host the Project
        • Infrastructure as Code Tool
        • Data Replication Strategy & Tool
        • HHS Communications Site
        • Communications Tooling: Email Marketing
        • Communications Tooling: Listserv
        • Use Ethnio for design research
        • Uptime Monitoring
        • Database Migrations
        • 30k ft deliverable reporting strategy
        • Public measurement dashboard architecture
        • Method and technology for "Contact Us" CTA
        • E2E / Integration Testing Framework
        • Logging and Monitoring Platform
        • Dashboard Data Storage
        • Dashboard Data Tool
        • Search Engine
        • Document Storage
        • Document Sharing
        • Internal Wiki ADR
        • Shared Team Calendar Platform
        • Cross-Program Team Health Survey Tool
        • Adding Slack Users to SimplerGrants Slack Workspace
        • Repo organization
        • Internal knowledge management
        • Migrate Existing API Consumers
      • Infra
        • Use markdown architectural decision records
        • CI/CD interface
        • Use custom implementation of GitHub OIDC
        • Manage ECR in prod account module
        • Separate terraform backend configs into separate config files
        • Database module design
        • Provision database users with serverless function
        • Database migration architecture
        • Consolidate infra config from tfvars files into config module
        • Environment use cases
        • Production networking long term state
    • Analytics
      • Open source community metrics
      • API metrics
  • DESIGN & RESEARCH
    • Brand guidelines
      • Logo
      • Colors
      • Grid and composition
      • Typography
      • Iconography
      • Photos and illustrations
    • Content guidelines
      • Voice and tone
    • User research
      • Grants.gov archetypes
  • REFERENCES
    • Glossary
  • How to edit the wiki
Powered by GitBook
On this page
  • Context and Problem Statement
  • Decision Drivers
  • Options Considered
  • Decision Outcome: simpler@grants.gov
  • Positive Consequences
  • Negative Consequences
  • Pros and cons of other options
  • simplergrantsgov@hhs.gov
  • Google collaborative inbox
  • Help Desk tool

Was this helpful?

Edit on GitHub
  1. Product
  2. Decisions
  3. ADRs

Method and technology for "Contact Us" CTA

PreviousPublic measurement dashboard architectureNextE2E / Integration Testing Framework

Last updated 28 days ago

Was this helpful?

  • Status: {Active}

  • Last Modified: 2023-12-20

  • Related Issue:

  • Deciders: Lucas, Andy, Sumi

  • Tags:

Context and Problem Statement

How might we give users an alternative to public comments (GitHub, Google Groups, listserv, etc.) so that they might submit questions or feedback more privately? Is email the appropriate method? And how might we manage this feedback channel?

Decision Drivers

  • The "Contact Us" method should not be (or feel) like a black box.

  • Incoming messages should be easy/simple to triage, respond to, and escalate to the appropriate channels.

  • Users should have clarity on how their messages are received, processed, and addressed.

  • To maintain transparency, it should be possible to implement a feedback loop that keeps users informed of the status of their inquiries (e.g. providing confirmation of receipt, updates on the progress, and resolutions).

Options Considered

  • Self-hosted .gov email address:

    • simpler@grants.gov

    • simplergrantsgov@hhs.gov

  • Help Desk tool (such as):

Decision Outcome: simpler@grants.gov

Chosen option: simpler@grants.gov, because it is simple and accessible for end users, can be easily managed by comms staff, and matches the Simpler.Grants.gov domain.

Positive Consequences

  • Simple email communication is a technology that most all users are fimiliar and comfortable with.

  • Since it does not require creation of accounts, or using 3rd-party ticketing dashboards, email is the most straightforward method by which users can submit their feedback.

  • Provisioning an email address is fast/inexpensive and does not require procuring a service subscription.

  • simpler@grants.gov echoes the project domain

  • @grants.gov is an official/trusted top-level domain (TLD)

Negative Consequences

  • We do not yet know the volume of submissions that will come through this feedback channel. A more robust Help-Desk-type of solution may be warranted in the future. We should revisit this decision if/when managing this inbox becomes unwieldy.

  • There are no built-in, convenient ways to run analyses on an email inbox, or tag and filter messages by categories. It may be difficult to track metrics on common/recurring themes. This may become more of an issue as the number of submissions grows.

Pros and cons of other options

simplergrantsgov@hhs.gov

This option has similar benefits as the chosen option. However, we decided that it's better that the TLD of the email match that of the site.

  • Pros

    • (See above chosen option)

  • Cons

    • (See above chosen option)

    • Difficult to read

    • User may be confused as to why HHS is the TLD

    • This @hhs.gov email address is not easily accessible to comms staff

Google collaborative inbox

Again, this option has similar benefits as the chosen option. However, we decided that it's better to use an official .gov TLD.

  • Pros

    • (See above chosen option)

  • Cons

    • (See above chosen option)

    • Not an official/trusted .gov email address

Help Desk tool

  • Pros

    • Automated workflows

    • Assigning, tracking, status

    • Labels, filters

    • Reporting and insights

    • Metrics on user satisfaction

  • Cons

    • Additional costs and/or maintenance

    • Ticketing system are typically used by large support teams and can sometimes feel like a black box or impersonal to users

This inbox can be easily triaged by the Simpler.Grants.gov project team via the "" feature.

Tools like , , , and others were given cursory consideration. There are many various benefits. However, it is not yet know whether their functionalities are necessary. These options should be reevaluated if managing the email inbox becomes unwieldy.

#682
Google collaborative inbox
Loop
Front
Odoo CRM
Send emails to Slack
Loop
Front
Odoo CRM