FDSN Source Identifier specification

This specification defines the construction of unique identifiers for data sources exchanged and archived in formats and services defined by the International Federation of Digital Seismograph Networks (FDSN) and related services and formats.

This repository contains the source of the documentation and serves as a coordination point for additions and changes to the specification.

Documentation rendered for the master branch can be found at: https://github.com/FDSN/source-identifiers/

Specification releases are at: https://docs.fdsn.org/projects/source-identifiers

Documentation source organization

The draft branch contains the latest draft documentation
Specification releases are branches from master, following a release: ** the version (in conf.py) is updated appropriately on the branch, never in master

Change procedure

To propose changes to the specification a submitter must provide two things:

A written description of the change (motivations, potential impact, etc.).
A fork of the most recent draft branch of the repository submitted as a pull request (PR) on GitHub. The PR should include the changes being proposed.

The procedure is as follows:

Submitter sends written proposal to the WG-II mailing list, with or without a link to a GitHub pull request or issue.
If written proposal is approved by WG-II but no pull request was submitted, the proposer should submit a pull request to the repository and send a link to the WG-II for technical review.
If the written proposal and technical review of the pull request are approved by WG-II, a gatekeeper will merge the pull request.

The change will then be included in the next release.

For technical discussion of a potential change without creating pull request, an issue may be created. The procedure for Working Group II, described above, must be followed for any changes.

Changes and issues should only be grouped together when logically related in order to streamline review and acceptance.