Page tree
Skip to end of metadata
Go to start of metadata



Versioning shall be based on the principles of semantic versioning. For existing specifications, any new releases will conform to the following style of version numbering.

  • MAJOR version when you make incompatible specification changes,
  • MINOR version when you make changes in a backward-compatible manner, and
  • PATCH version when you make backward-compatible editorial fixes (e.g., updating URLs in references).

Document Metadata

Each document to have the following metadata at the top:

  • Version History
  • Reference pdf
  • DOI
  • License
  • Supporting Material

Additional Guidelines

  1. Each URI will lead to an HTML version of the specification.  The canonical version of the specification must be on the REFEDS website, not the wiki or in GitHub.
  2. Each HTML version will reference a PDF version to be kept on Zenodo.
  3. Each version will have DOI, to be obtained via Zenodo.
  4. Each document to have a Creative Commons CC BY SA 4.0 license attached, as per the REFEDS Participant's Agreement.
  5. All supporting material to be kept on the REFEDS wiki.
  • No labels