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
  • Overview
  • Context and Problem Statement
  • Decision Drivers
  • Options Considered
  • Decision Outcome
  • Pros and Cons of the Options
  • Google Workspace Solution (Google Drive with Google Docs Editors Suite)
  • GitHub
  • GitBook
  • LibreOffice
  • Links

Was this helpful?

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

Document Sharing

  • Status: Accepted

  • Last Modified: 11/14/2024

  • Deciders: Lucas, Julius, Billy, Sarah, Margaret, Andy

Overview

Context and Problem Statement

The SimplerGrants Project needs a document sharing solution in order to collaborate on work items and deliverables. Examples of work items to be shared for collaboration include: meeting notes, collaborative documents used by the co-design group or code challenge participants, slide decks for internal and/or external briefings, and various other project documents.

The goal of this ADR is to evaluate document sharing solutions and determine which one best fits the needs and objectives of this project based on the decision criteria outlined below.

Decision Drivers

  • Hosting: Must be SaaS to ensure accessibility and reduce maintenance.

  • Usability: Non-technical users should be able to access and create content with minimal training or guidance.

  • Read-only mode: Must have the ability to lock editing for some users.

  • Comments: Reviewers should be able to leave in-line comments on content that they are reviewing.

  • Version History: Editors should be able to see and restore previous versions of a given page.

  • File Types: The solution must be compatible with industry standard document file types, including .doc, .pdf, xlsx, .rtf, .txt, .html, .md, .epub, .ods, .tsv, and .csv. The solution should allow users to create and save their documents in these file types, open existing documents in these file types, and edit these file types.

  • Storage: We don’t have specific storage needs identified at this time, but we would like to be cognizant of storage limits that exist.

  • Permissions: Permissions hierarchies should be robust enough to allow creation of directories that may be shared with the entire program or only with select members of the program.

  • Maintenance Costs: It should not be prohibitively expensive to maintain the doc sharing platform, both in terms of staff time/resources and direct costs (e.g. hosting fees).

Options Considered

  • Google Workspace

  • Github

  • Gitbook

  • LibreOffice

Decision Outcome

SimplerGrants will use Google Drive and Google Docs Editors Suite within existing Google Workspace instances from contractors. Additional decisions are needed around which instance will be used for what purpose.

Positive Consequences

Google Workspace is a robust solution that meets program needs, needs very little work to implement, does not have additional costs, and has generous storage policies.

Negative Consequences

HHS may require contractors to upload, organize, and maintain the files and folders on Google Drive in order to use their Google Workspaces since they will only have access as guests. Additional discussions between contractors will be needed to understand how each Google Workspace will be used.

Pros and Cons of the Options

Google Workspace Solution (Google Drive with Google Docs Editors Suite)

Google Workspace is a collection of cloud computing, productivity, and collaboration tools. This solution would entail using the Google Drive and Google Docs Editors Suite tools from Google Workspace in order to satisfy the document sharing requirements.

Details

  • Hosting: SaaS

  • Pricing: This document assumes that we would use Google Workspace Solutions that one or more SWIFT contractors already have, which results in no added cost for the program.

  • Usability: Simple for non-technical users

  • Read-only mode: Yes

  • Comments: Yes, in-line

  • Version History: Yes

  • File Types: supports all required file types, and max file size is 5TB.

  • Storage: Maximum item quantity is 500,000. No size limit.

  • Permissions: Can be configured by drive, folder, or document. Allows them to be available to anyone with the link, a specific set of individuals, or private.

  • Maintenance Costs: Low to none

Pros:

  • Easy and fast to implement, since it is already being used

  • Does not need to be acquired because contractors already have it

  • Multiple contractors with instances of it mean there are more choices for implementation

  • No training required

  • No additional costs

  • Generous storage policy

Cons:

  • Multiple contractors with their own Google Workspace instances means some agreement will be needed in order to figure out who is hosting what and where.

  • HHS team members will require file management from the contractors whose instance they are using, as they will be guest users.

  • HHS team members will need to create their own Google accounts to access Google Workspace and may lack familiarity with the tool. Additional training could be required.

GitHub

GitHub is a public repository that allows for hosting documents and other content that isn't stored directly within the code repository itself.

Details

  • Hosting: SaaS

  • Pricing: Free for public repositories

  • Usability: Not great for non-technical users

  • Read-only mode: Yes

  • Comments: No

  • Version History: Yes

  • File Types: Supports storage of all required file types, editing of markdown files, and max file size is 100 MB.

  • Storage: Total repo size should be less than 5 GB.

  • Permissions: Permissions set per repository (public or private)- all documentation in a repo is available to anyone who can access the repo.

  • Maintenance Costs: None

Pros

  • Available for free with public repositories

  • Anyone with a github license and permissions may use

Cons

  • One of the hardest-to-use tools for non-technical audiences

  • Supports a very limited set of media formats, mainly markdown and images

  • Small repo storage max means the program will outgrow it quickly

GitBook

GitBook is a Software as a Service (SaaS) platform for creating and managing public documentation for a project. GitBook prioritizes version control and collaboration by offering first class support for reviewing and merging content changes. It has become a common documentation and wiki tool for many open source projects.

Details

  • Hosting: SaaS

  • Pricing: $6.70 (plus) or $12.50 (pro) per user per month

  • Usability: Program feedback has been mixed. Some training required for non-technical users.

  • Read-only mode: Yes

  • Comments: Yes

  • Version History: Yes

  • File Types: Does not specify file types supported for storage, supports editing of markdown files, and max file size is 100 MB.

  • Storage: No storage limit- 500,000 item limit

  • Permissions: Can be configured by user or organization. Several different options available.

  • Maintenance Costs: see pricing.

Pros

  • Public spaces and pages are well organized and searchable which would allow for easy finding of documents

  • Supports a wide variety of media and content types

  • Supports beginning-of-time page history and version comparison

Cons

  • Not meant to be a document sharing platform, so document sharing is overly complicated

  • Not so friendly for non-technical users

  • Doesn’t support editing of file types other than markdown

  • External users cannot directly comment or suggest changes in the app

  • 100 MB max file size may not be enough in some cases

LibreOffice

LibreOffice, the successor to OpenOffice, is compatible with O365 files and is backed by a non-profit organization. It has native support for Open Document Format (ODF), an open source document format, and has editors for documents, slides, spreadsheets, drawing, databases, and formula editing. It is an open source software.

Details

  • Hosting: Locally hosted- no SaaS solution available.

  • Pricing: Free

  • Usability: Easy to moderate for non-technical users

  • Read-only mode: Yes

  • Comments: Yes

  • Version History: Yes

  • File Types: all required file types plus ODF

  • Storage: none- no hosted solution

  • Permissions: none- no hosted solution

  • Maintenance Costs: Low to none for editing. However, lack of hosted/SaaS solution implies a very high cost to find a solution that allows for sharing documents.

Pros

  • Impressive commitment to open source ethos- much like SimplerGrants

  • Supports many types of files and editing

Cons

  • Lack of a hosted/SaaS solution disqualifies this solution.

Links

PreviousDocument StorageNextInternal Wiki ADR

Last updated 1 month ago

Was this helpful?

Google Workspace
Github
Gitbook
LibreOffice