Difference between revisions of "Collaboration Tools"

Jump to: navigation, search
(10 intermediate revisions by 6 users not shown)
Line 1: Line 1:
Collaboration among a research team is a critical part of nearly all impact evaluations. With the general availability of low-cost cloud collaboration tools, it is important to use tools that effectively achieve the goals of sharing access to data and content, while protecting the privacy, integrity, and history of that content and imposing as low of a learning cost on other collaborators as possible.
Collaboration among a research team is a critical part of nearly all [[Primary Data Collection | data collection]] and impact evaluation activities . With the general availability of low-cost cloud collaboration tools, it is easier and more important than ever to use tools that effectively share access to data and content; protect the privacy, integrity, and history of that content; and impose as low of a learning cost on other collaborators as possible. This page outlines collaboration tools for analysis and paper writing.
 
==Read First==
*[[Getting started with GitHub | GitHub]] facilitates collaborative coding and preserves every version history of code and outputs
*Cloud Sync tools like [https://www.dropbox.com Dropbox] are useful for sharing code, data, and outputs. While they have limitations (i.e. multiple collaborators often can’t simultaneously work on the same file), they come with a low learning curve and are easy to implement.
*[https://www.overleaf.com/ Overleaf] is a web-based LaTeX collaboration tool that allows multiple authors to simultaneously edit documents.
 
== Analysis ==
===GitHub===
[[Getting started with GitHub | GitHub]] allows for multiple data analysts to work on the same project simultaneously by keeping a local copy of all analysis code and merging final versions together in a centralized repository. GitHub preserves every version history of code and outputs. This makes it easy to recover old code snippets after deleting them from the main production branch and to avail these code snippets to others who may want to review analyses that did not appear in the final publication.
 
===Cloud Sync Tools===
Cloud Sync tools, such as [https://www.dropbox.com Dropbox], are commonly used to share code, data, and outputs with collaborators. Unlike GitHub, sync tools have limited version histories and typically do not allow multiple collaborators to work simultaneously on the same file without version conflicts arising. However, they bear more similarity to traditional filesystem structures, meaning that the learning curve is nearly zero for working on files in sync tools.
 
== Paper Writing==
===Overleaf===
[https://www.overleaf.com/ Overleaf] is a web-based LaTeX collaboration tool that allows multiple authors to simultaneously edit documents. It maintains a folder structure containing a main document, a bibliography document, and images and other resources. It supports limited integrations with Git and Dropbox, and is currently under active redevelopment following a merger with ShareLaTex, a similar service.
 
While Overleaf is based on a LaTeX structure, it now offers a "Google-Docs-like" editor and limited comments and version histories, making it easier to collaborate with coauthors who are more comfortable with [https://en.wikipedia.org/wiki/WYSIWYG WYSIWYG] editors like Word.
 
== Additional Resources ==
*DIME Analytics’ [https://github.com/worldbank/DIME-Resources/blob/master/git-1-intro.pdf Intro to GitHub]
*DIME Analytics’ guides to  [https://github.com/worldbank/DIME-Resources/blob/master/git-2-github.pdf 1] and [https://github.com/worldbank/DIME-Resources/blob/master/git-3-flow.pdf 2] to Using Git and GitHub
*DIME Analytics’ [https://github.com/worldbank/DIME-Resources/blob/master/git-4-management.pdf Maintaining a GitHub Repository]
*DIME Analytics’ [https://github.com/worldbank/DIME-Resources/blob/master/onboarding-3-git.pdf Initializing and Synchronizing a Git Repo with GitHub Desktop]
*DIME Analytics’ [https://github.com/worldbank/DIME-Resources/blob/master/onboarding-4-gitflow.pdf Using Git Flow to Manage Code Projets with GitKraken]
*An [http://web.simmons.edu/~wilsonjd/LIS488/website/OverleafTutorial.pdf Introduction to Overleaf] by Alli Gofman and Jaclyn Wilson
 
[[Category: Collaboration Tools]]

Revision as of 14:25, 20 April 2020

Collaboration among a research team is a critical part of nearly all data collection and impact evaluation activities . With the general availability of low-cost cloud collaboration tools, it is easier and more important than ever to use tools that effectively share access to data and content; protect the privacy, integrity, and history of that content; and impose as low of a learning cost on other collaborators as possible. This page outlines collaboration tools for analysis and paper writing.

Read First

  • GitHub facilitates collaborative coding and preserves every version history of code and outputs
  • Cloud Sync tools like Dropbox are useful for sharing code, data, and outputs. While they have limitations (i.e. multiple collaborators often can’t simultaneously work on the same file), they come with a low learning curve and are easy to implement.
  • Overleaf is a web-based LaTeX collaboration tool that allows multiple authors to simultaneously edit documents.

Analysis

GitHub

GitHub allows for multiple data analysts to work on the same project simultaneously by keeping a local copy of all analysis code and merging final versions together in a centralized repository. GitHub preserves every version history of code and outputs. This makes it easy to recover old code snippets after deleting them from the main production branch and to avail these code snippets to others who may want to review analyses that did not appear in the final publication.

Cloud Sync Tools

Cloud Sync tools, such as Dropbox, are commonly used to share code, data, and outputs with collaborators. Unlike GitHub, sync tools have limited version histories and typically do not allow multiple collaborators to work simultaneously on the same file without version conflicts arising. However, they bear more similarity to traditional filesystem structures, meaning that the learning curve is nearly zero for working on files in sync tools.

Paper Writing

Overleaf

Overleaf is a web-based LaTeX collaboration tool that allows multiple authors to simultaneously edit documents. It maintains a folder structure containing a main document, a bibliography document, and images and other resources. It supports limited integrations with Git and Dropbox, and is currently under active redevelopment following a merger with ShareLaTex, a similar service.

While Overleaf is based on a LaTeX structure, it now offers a "Google-Docs-like" editor and limited comments and version histories, making it easier to collaborate with coauthors who are more comfortable with WYSIWYG editors like Word.

Additional Resources