Editing EPrints Glossary (section)

== R ==
=== Regular user ===
This is a [[#User|user]] whose account provides them with standard access to an [[#Archive|archive]] allowing then to deposit [[#EPrint|eprints]] for [[#Review buffer|review]] and manage their [[#User profile|user profile]].  With [[#EPrints repository software|EPrints repository software]] this type of user account just referred to as "user".  When describing this user, the adjective "regular" is used to distinguish this specific type of user from users more generally.

=== Repository ===
This is an individual installation of the [[#EPrints repository software|EPrints repository software]] onto a server.  A repository may host many [[#Archive|archives]] but they all use the same [[#Core codebase|core codebase]].  Sometimes a repository will host only a single archive and therefore, the terms repository and archive are often used interchangeably and often the latter is referred to as a "repository archive".

=== Repository admin ===
Short for repository administrator, this is a level of [[#User|user]] account that give maximum access to an [[#Archive|archive]].  Allowing the user to carry out [[#Regular user|regular user]] actions such as depositing an [[#EPrint|eprint]], [[#Editor|editorial]] actions like reviewing eprints submitted by a regular user and administrative actions, in particular those available through the [[#Admin menu|admin menu]].

=== Request ===
This is a [[#Data object|data object]] that relates to a request made by a [[#User|user]] or [[#Visitor|visitor]] about a specific [[#EPrint|eprint]] or [[#Document|document]].  The most common request is [[#Request copy|request copy]] by a visitor for access to a document that is [[#Document security|restricted]].  In some [[#Archive|archives]] it may also be enabled to allow users to submit change requests to eprints in the [[#Live archive|live archive]], if they notice an error in their [[#Metadata|metadata]].

=== Request copy ===
Sometimes also referred to as "request a copy" this is a button or link on an [[#Abstract page|abstract page]], allowing a [[#Visitor|visitor]] to request a copy of a [[#Document|document]] that is [[#Embargo|currently]] [[#Document security|restricted]].  If the [[#EPrint|eprint]] has its ''contact email'' [[#Metadata field|metadata field]] this will email that address with the request sent by the visitor.  If that email addresses matches that of a [[#User|user]] the email sent will contain accept and reject links.  Where the former will provide a link in the email response to the visitor, giving them temporary access to the restricted document.

=== REST API ===
[[#EPrints repository software|EPrints repository software]] provides a standard [https://www.redhat.com/en/topics/api/what-is-a-rest-api REST API] that allows third-party applications to create, read, update and destroy various [[#Data object|data objects]] within an [[#Archive|archive]].  In EPrints, the REST API provides similar functionality to the [[#CRUD API|CRUD API]], albeit under a URL path like:
 https://example.eprints.org/rest/

=== Retired ===
This is an [[#EPrint status|eprint status]] for [[#EPrint|eprints]] that have been in the [[#Live archive|live archive]] but have been removed for some reason.  The advantage of retiring an eprint rather than deleting it, is that it can be restored, if it was removed erroneously from the live archive.  Also, the [[#Abstract page|abstract page]] will display a message saying the eprint has been removed rather than a "404 Not Found".

=== Review buffer ===
This is an [[#EPrint status|eprint status]] of [[#EPrint|eprints]] that have be deposited by a [[#User|user]] but need to be reviewed by an [[#Editor|editor]] before being added to the [[#Live archive|live archive]].  Review buffer also refers to all eprints that currently have this status and can be accessed view the ''Review'' link in the [[#User menu|user menu]].

=== Revision ===
Some [[#First class data object|first class data objects]] support [[#Revision file|revision files]] and [[#History|history data objects]] to track their changes over time.  By default there are only [[#EPrint revision|eprint revisions]].

=== Revision file ===
This is a file on disk that stores [[#EPrints XML|EPrints XML]] markup for the [[#Metadata|metadata]] for a [[#Data object|data object]].  By default, revision files are only generated for [[#EPrint|eprints]] and can be found within the ''revisions'' directory for that eprint's sub-directory under the [[#Documents directory|documents directory]].  E.g.
 EPRINTS_PATH/archives/ARCHIVEID/documents/disk0/00/00/00/01/revisions/1.xml
The revisions are used in an eprint's [[#History tab|history tab]] to generate a listing of changes between one [[#EPrint revision|revision]] and the next.