Skip to main content
U.S. flag

An official website of the United States government

Dot gov

The .gov means it’s official.
Federal government websites often end in .gov or .mil. Before sharing sensitive information, make sure you’re on a federal government site.

Https

The site is secure.
The https:// ensures that you are connecting to the official website and that any information you provide is encrypted and transmitted securely.

Collaboration tools

Collaboration is a critical part of our work and organizational philosophy. There are a variety of tools to support our teams’ collaboration and communication needs. While some tools are used often within TTS, working with an external partner may necessitate the use of a different tool that’s best for the partner team and their internal IT policies.

References to specific products or organizations are for information only and don’t constitute an endorsement of the product/company.

Setting up tools with partners

Before the project even begins, the project’s Account Manager should begin the discussion of collaboration tools in pre-flight calls with partners. The goals at this stage are to:

Early in the project, 18F and the partner team should agree upon a basic suite of collaboration tools to support team activities. Consider these general strategies:

If your partner agency is reluctant to use collaboration tools, learn why. Is it a security question? Is there a burdensome technology approval process? Is there another tool already in place to achieve the same goal? Discovering the root causes to their reluctance may help inform your project and ensure productivity.

If you’re going to use a partner’s tools, see the information below.

Lastly, don’t wait until the end of an engagement to think about transitioning documents, code or client accounts from the tools that you use to collaborate. It’s important to have a partner-owned account or alternative in order to avoid creating blockers at the end of an engagement.

Using TTS tools

Potential tools

Below are potential tools to help your team and partner collaborate.

Instant messaging

Slack is an instant messaging tool that uses themed chat rooms (called channels) to help teams quickly communicate on a daily basis, in an open, collaborative way. The 18F team will create a channel for your project in our Slack workspace, which you can access from your web browser. It may be useful to read about what managers need to know about social tools when getting started.

Compliance and records considerations - Slack is ATO'd for use in GSA, and has a FedRAMP Agency Authorization at the [LI-SaaS impact level](https://tailored.fedramp.gov/). Slack operates within the AWS public cloud. - All communication in Slack are considered records and conform to GSA's record management policy.

Here are some common barriers to using Slack and workarounds to try:

Other instant message services to consider or ask your partner about - **Skype:** Skype provides instant messaging and video teleconferencing capabilities within a partner network. - **Google Hangouts Chat:** Google Hangouts Chat is the instant messaging service within the Google G Suite, and typically integrated with Gmail, Calendar, Drive, and Sites. - **Microsoft Teams:** Microsoft Teams provides chat capabilities similar to Slack, with the ability to collaborate around themed channels, direct messaging to multiple individuals, etc. Microsoft Teams may be the collaborative tool of choice for partners that have adopted Microsoft services.

Video conferencing

Google Meet and Zoom enable staff all over the country to video chat and screenshare in remote meetings. We’ve found that video calls help teams stay connected and are easier to manage than conference calls for large groups.

Compliance and records considerations - [Zoom for Government has a FedRAMP Agency ATO](https://marketplace.fedramp.gov/#/product/zoom-for-government) Moderate Impact authorized since April 2019. Agencies using the service include GSA, DHS, and Customs and Border protection. - [Google G Suite has a FedRAMP Agency ATO](https://marketplace.fedramp.gov/#/product/google-g-suite) Moderate Impact authorized since January 2016. Agencies using the service include GSA, DOE, DHS, and others. - Recordings of meetings are records and should be treated as such.

Here are some common barriers to using these tools and some workarounds to try:

Other video teleconferencing services to consider or ask your partner about - **Cisco Webex** - **Skype** - **BlueJeans**

Sharing files

Google Drive is a storage and collaboration platform for spreadsheets, slide decks, and text documents. Documents on Google Drive are not public, but can be shared among team members. 18F can give your team access to our Google Drive so everyone can collaborate.

Compliance and records considerations - [Google G Suite has a FedRAMP Agency ATO](https://marketplace.fedramp.gov/#/product/google-g-suite) Moderate Impact authorized since January 2016. Agencies using the service include GSA, DOE, DHS, and others.

Here are some common barriers to using Drive and some workarounds to try:

Other file sharing services to consider or ask your partner about - **Microsoft SharePoint:** a browser-based collaboration and documentation management system, similar to Google Drive. Recent releases of SharePoint provide allow teams to rapidly create internal websites (like Google Sites) and collaboratively create and manage content in documents, spreadsheets, and slides. - **[Max.gov](https://portal.max.gov/portal/home):** a government-wide suite of advanced collaboration, information sharing, data collection, publishing, business intelligence, and authentication tools and services used to facilitate cross-government collaboration and knowledge management. - **[DOD SAFE](https://safe.apps.mil)**, (Secure Access File Exchange): SAFE is a service to exchange unclassified files that are too large to share via email. SAFE can handle files up to 8.0 GB. - **[Intelink's](https://www.intelink.gov/my.policy):** IntelDocs, allows users to share unclassified files. The service has a file size limit of 100MB and folder limit of 1GB.

Tracking project tasks

Trello is a project management tool that organizes information into lists. Teams often use it to track specific tasks through different stages (such as backlog, in progress, in review, and done). Trello boards can be private or public.

Compliance and records considerations: - GSA Tech Portfolio is working on a FedRAMP application as of January 2020. Members of TTS can use it and will be notified if anything changes. - Trello boards should be considered records.
Trello alternatives - **Zenhub:** Not recommended from a compliance perspective. No FedRAMP in progress, no GSA IT approval for use of the service. From a user perspective, it's great that it works within GitHub and provides higher-level scoping and linking (e.g., epics and dependencies). - **GitHub Projects:** Not recommended from usability/UI perspective, as the interface is basic without the richness of other planning systems or the simplicity of Trello. Compliance/records considerations are the same as for GitHub. - **Jira:** The GSA IT Jira instance is not recommended. Like Zenhub, it integrates with GitHub and provides higher-level scoping and linking (e.g., epics and dependencies). It's pretty difficult to grant access to outsiders, and it's pretty heavyweight and difficult to configure. - **Microsoft Azure Devops Boards:** Bundled with Azure, but not within FedRAMP services in scope.

Viewing/scheduling calendars

Google Calendar is the calendar tool that comes with gmail and G Suite. The Handbook has guidelines and requirements for providing partners with access.

Compliance and records considerations - [Google G Suite has a FedRAMP Agency ATO](https://marketplace.fedramp.gov/#/product/google-g-suite) Moderate Impact authorized since January 2016. Agencies using the service include GSA, DOE, DHS, and others.

Here are some common barriers to using Google Calendar and some workarounds to try:

Development and Documentation

GitHub is an online code storage and collaboration platform. 18F will create a repository (commonly called a repo) for the project and use it to store both documents and code. By default, 18F’s work with your team on GitHub will be visible to the public. Your 18F team can tell you more about the benefits of working in the open. Teams may also use GitHub, as well as browser add-ons that complement it, to collaboratively track project tasks.

Compliance and records considerations - GitHub is ATO'd for use in GSA and has [a FedRAMP Agency Authorization at the LI-SaaS impact level](https://marketplace.fedramp.gov/#/product/github-enterprise-cloud). GitHub operates their own data centers. - All communication in GitHub is considered a record and conforms to GSA's record management policy.
Additional documentation support - **[Github Wiki](https://help.github.com/articles/about-github-wikis/)** is a section of GitHub that some teams use to store supporting documents. Each GitHub repository has its own wiki, and anyone on your team can edit the wiki. A wiki is a good place to store documents that the team will refer back to throughout a project such as design principles, research results, or a project roadmap.

Remote Whiteboarding

Mural is an online collaborative whiteboard tool. It allows teams to collectively generate ideas with sticky notes and sorting them around as if they were in the same room. You don’t need an account to participate and you can access the tool from any browser.

Compliance and records considerations - Mural is hosted on Azure commercial public cloud. It has a GSA ATO but doesn't have a FedRAMP authorization or anything in process. - Mural generally wouldn't be used to store “records” but instead to organize information for discussion purposes. GSA Records Officer has determined that “this product likely creates a number of record types. However, the specific types of records created will depend on the context in which this product is used.” As such, be sure to export and archive information from Mural periodically. - Truly low-impact: Mural shouldn't be used to store anything confidential or authoritative. Instead, use it for ephemeral organization of information and production visualizations. Non-GSA participants are invited to use the service anonymously.

Helping partners make the most of these new tools

Here are some recommendations for how to level up our partners’ skills:

Provide a training or learning materials

Learn by doing/watching/failing

Develop shared conventions with your partner

Helping partners transition off collaboration tools

Using partners’ tools

Per the IT Standards policy, section 2(e):

Collaboration with another agency through software or cloud services which they use for managing non-GSA data (either data owned by that agency or public data) does not require security or Section 508 compliance review, as that responsibility is assumed by the providing agency.  Other policies which may restrict the use of GSA Enterprise Accounts or the release of GSA-owned data may still apply.

In other words, it is generally fine to use a tool authorized and maintained by a partner agency. If you’re not sure, reach out to ispcompliance@gsa.gov and devops@gsa.gov.