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
  • Positive Consequences
  • Negative Consequences
  • Pros and Cons of the Options
  • Links

Was this helpful?

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

Dedicated Forum for Simpler.Grants.gov Community

PreviousADRsNextRecording Architecture Decisions

Last updated 28 days ago

Was this helpful?

  • Status: Active

  • Last Modified: 2025-02-25

  • Related Issue:

  • Deciders: Brandon

  • Tags: open source, community

Context and Problem Statement

We want to foster a more engaged and sustainable community space for Simpler Grants.gov (SGG) open-source & co-design community discussions.

  • Our existing community channels—Slack (with ~30–50 invitees) and Google Groups—are underutilized and have not achieved the kind of broad, asynchronous engagement we want.

  • Slack is a synchronous tool that can exclude a certain audience. It is a powerful tool for highly engaged users who require near real time conversations with other known collaborators. In the current stage of SGG we have found that although internal staff find this tool highly useful, that external users are turned away by the complexity and fast moving nature of a realtime discussion platform.

  • Google Groups remain largely unused. We have not publicized our Google Group’s existence to any members of the public or even to our internal team.

  • We need a dedicated discussion space that is accessible to a wide range of users (including non-technical people), public and discoverable via search engines, and capable of storing institutional knowledge over time. It also needs to be less real time to allow newer users to engage at a pace that feels more comfortable to them.

Decision Drivers

  1. Accessibility and Discoverability: Must allow for search engine indexing so potential users can stumble upon and engage with the forum.

  2. Ease of Use: Low barrier to entry for both technical and non-technical audiences.

  3. Asynchronous Collaboration: Ability to store long-term discussions, Q&A, and historical context in a searchable format.

  4. Integration: Should ideally integrate well with GitHub or other existing tools, or at least link seamlessly from the main SGG site.

  5. Moderation and Maintenance Effort: Should not significantly burden our team, but allow for moderation controls and community management.

  6. Security: Our approach keeps data secure and fulfills all relevant HHS security policies, where applicable.

Options Considered

  1. GitHub Discussions

  2. Discourse

Decision Outcome

Chosen option: Discourse Because it best meets key decision drivers around search engine discoverability, user-friendliness for non-technical audiences, flexible configuration, and the ability to host on a custom domain or subdomain.

Positive Consequences

  • Enhanced Visibility: A dedicated Discourse instance, likely on a subdomain (e.g., community.simplergrants.org), can be indexed by search engines, increasing discoverability.

  • User-Friendly Experience: Discourse provides a clean UI, straightforward signup, and intuitive navigation.

  • Community Growth: Easier for members (technical and non-technical) to find and join discussions; improved Q&A and knowledge retention.

Negative Consequences

  • Hosting and Maintenance Overhead: Discourse requires hosting (self-hosted or managed) and regular maintenance (updates, backups, etc.).

  • Moderation Responsibility: We will need to maintain active moderation to keep the forum healthy and welcoming.

  • Separate Logins: Users need to create an account distinct from GitHub unless we configure a single-sign-on (SSO) solution.

  • FedRAMP Compliance: We have investigated and determined that DIscouse is not FedRAMP compliant and does not have any plans to become compliant.

Pros and Cons of the Options

Option 1: GitHub Discussions

Description: Enable GitHub Discussions in the SGG repository.

  • Pros:

  • Already integrated into the GitHub ecosystem; no new hosting required.

    • Familiar to technical contributors.

    • Minimal setup and maintenance effort.

  • Cons:

    • Limited discoverability for non-technical folks (requires GitHub account, repository context).

    • Forum remains “buried” within the repository rather than a top-level domain.

    • Less intuitive for those unfamiliar with GitHub conventions.

Option 2: Discourse

Description: Set up a dedicated Discourse instance on a standalone domain or subdomain.

  • Pros:

    • Search-engine-friendly; easier for new community members to stumble upon.

    • Rich discussion features (threading, tagging, badges, user trust levels, etc.).

    • Established platform used by many open-source projects with robust plugin and customization options.

  • Cons:

    • Requires hosting (self-hosted or SaaS) and ongoing maintenance (updates, backups).

    • Separate account system (unless we invest in an SSO approach).*

    • Potentially higher initial setup complexity.

* The Standard $100/mo version of Discourse has GitHub auth.

Links

(Example)

(Example)

#3314
Mural
Discourse
GitHub Discussions Documentation
React GitHub Discussions
NASA Core Flight Systems GitHub Discussions