File versioningVersion control is method used to track file or file set changes over time so that you can recall older versions at a later time.

File versioning can be as simple as using file naming conventions like suffixes *_v1, *v2, *vn, or you could use a version control software (VCS).

Version control software allows multiple people on a team to work together on the same project at the same time. It manages changes to all types of text-based files, like scripts and web pages as well as some proprietary digital formats.

Version control records changes (additions, deletions, replacements) of individual files, tracks updates, and allows branching of projects that may be later integrated into the parent project.

Comic: Jorge Cham. "notFinal.doc" http://phdcomics.com/comics/archive_print.php?comicid=1531

 

Advantages to Version Control Software

There are three advantages to version control software:

  1. Infinite undos: VSC allows users to revert to a previous version of a file or file set to restore or recover a previous state of a program application or website. This allows you to restore accidentally deleted or overwritten files in a project, or to restore file sets from a prior version save.
  2. Branching and experimentation: This is powerful as it allows you to test out new features in programming code or branch out on a different path without affecting your collaborator's work in the production code. Later, your branch can be merged in with the production, saved, or discarded as necessitated.
  3. Collaboration: Collaborators can work locally on the file while the VCS handles the tasks of merging changes and keeping the files and directory trees in sync. The VSC also promotes accountability, tracking who's made which changes and when, so any questions about the changes can be followed up with the appropriate person.
     

Software Tools

Below are a some version control software and and file sharing tools used at Harvard.  It is important to note the following:

  1. Since Harvard does not necessarily host each of these products, at the close of a project, be sure to retain a copy of the file sets to be saved in the Harvard or sponsored research archive at the close of the project, they must provide Harvard with a copy of the files.
  2. If your files contain any proprietary or confidential information, you must store these in a Harvard Security Level 4 or 5 certified environment.
      • Git

        Git is a distributed version control tool that can manage a development project's source code history. Git is the most common and widely accepted version control software, which you can run locally on your computer. Learn more about Git.

         

      • GitHub

        GitHub is a web-based service for Git repositories (i.e., groups of tracked files). GitHub is commonly used for managing and sharing different versions of code for programming projects, but it can be used just as effectively for version control of other types of files, such as text documents. GitHub has a huge open-source community. Get started with GitHub.

      • GitLab

        GitLab is an open source software that provides a Git repository hosting service and collaborative revision control. GitLab has project management, issue tracking, and free private repository hosting. See more about GitLab.

      • Bitbucket

        Bitbucket is a web-based version control repository hosting service owned by Atlassian, for source code and development projects that use Git. Bitbucket tends to have mostly enterprise and business users. Learn more about Bitbucket.

      • Subversion

        Apache Subversion is a server-client software versioning and revision control system. Software developers use Subversion to maintain current and historical versions of files such as source code, web pages, and documentation. Get started with Apache Subversion.

      File Sharing Platforms

      • Dropbox

        Dropbox is a file hosting service that offers cloud storage, file synchronization, personal cloud, and client software. Dropbox saves all of your lost files and restores older versions of files. Good for up to level 3 data, external/internal file sharing, co-authoring, and version control.
         Consumer Dropbox for SPH, and Dropbox for Business for HMS

      • OneDrive

        Microsoft 365 OneDrive is a personal file storage for individual workspace productivity and organizational file storage for management of departmental document libraries and files. Good for up to level 3 data, external/internal file sharing, co-authoring, and version control.
        See the HUIT Service Catalog for more on Onedrive and SharePoint.

      • Google Drive

        Google Drive is a file storage and synchronization service that allows users to store files on their servers, synchronize files across devices, and share files. Google keeps track of each revision to the file with built-in version tracking and the ability to get back to earlier file versions. Google Apps for Harvard are supported at some school.

      • Open Science Framework

        Open Science Framework (OSF) provides free and open source project management support for researchers across the entire research lifecycle. As a flexible repository, it can store and archive research data, protocols, and materials. OSF has built-in version control and retains all copies of a file added to OSF, and further provides access to versions of files stored on third-party storage providers. Get started with Open Science Framework.