repository (version control)
{{short description|Metadata storage for software revision control}}
In version control systems, a repository is a data structure that stores metadata for a set of files or directory structure.{{cite web|title=SVNBook|url=http://svnbook.red-bean.com/en/1.7/svn.basic.version-control-basics.html#svn.basic.repository|access-date=2012-04-20}} Depending on whether the version control system in use is distributed, like Git or Mercurial, or centralized, like Subversion, CVS, or Perforce, the whole set of information in the repository may be duplicated on every user's system or may be maintained on a single server.{{cite web
|url=https://homes.cs.washington.edu/~mernst/advice/version-control.html
|title=Version control concepts and best practices
|access-date=2020-07-10
|date=2018-03-03
|url-status=live
|archive-url=https://web.archive.org/web/20200427074258/https://homes.cs.washington.edu/~mernst/advice/version-control.html
|archive-date=2020-04-27
}} Some of the metadata that a repository contains includes, among other things, a historical record of changes in the repository, a set of commit objects, and a set of references to commit objects, called heads.
The main purpose of a repository is to store a set of files, as well as the history of changes made to those files.{{cite web|title=Getting Started - About Version Control|url=http://git-scm.com/book/en/v2/Getting-Started-About-Version-Control|publisher=Git SCM}} Exactly how each version control system handles storing those changes, however, differs greatly. For instance, Subversion in the past relied on a database instance but has since moved to storing its changes directly on the filesystem.{{cite book |author1=Ben Collins-Sussman |author2=Brian W. Fitzpatrick |author3=C. Michael Pilato |title= Version Control with Subversion: For Subversion 1.7 |year= 2011 |chapter= Chapter 5: Strategies for Repository Deployment |url= http://svnbook.red-bean.com/en/1.7/svn.reposadmin.planning.html#svn.reposadmin.basics.backends | publisher = O'Reilly}} These differences in storage techniques have generally led to diverse uses of version control by different groups, depending on their needs.{{cite web|title=Different approaches to source control branching|url=https://stackoverflow.com/questions/1332746/different-approaches-to-source-control-branching|website=Stack Overflow|access-date=15 November 2014}}
Overview
File:GitLab running 14.3.0-pre (2021-08).png, an open source code forge.]]
In software engineering, a version control system is used to keep track of versions of a set of files, usually to allow multiple developers to collaborate on a project. The repository keeps track of the files in the project, which is represented as a graph.
A distributed version control system is made up of central and branch repositories. A central repository exists on the server. To make changes to it, a developer first works on a branch repository, and proceeds to commit the change to the former.
Forges
A code forge is a web interface to a version control system. A user can commonly browse repositories and their constituent files on the page itself.
=Static web hosting=
While forges are mainly used to perform version control operations, some forges allow users to host static web pages by uploading its source code (such as HTML and JavaScript, but not PHP) to a repository. This is usually done in order to provide documentation or a landing page for a software project.
The use of repositories as a place to upload web documents allows version control to be integrated, and additionally allows quick iteration because changes are pushed through the Version Control System instead of having to upload the file through a protocol like FTP.{{Cite web|url=https://pages.github.com/|website=GitHub|title=GitHub Pages {{!}} Websites for you and your projects, hosted directly from your GitHub repository.}}
Examples of this kind of service include GitHub Pages and GitLab Pages.