Skip to content

Commit

Permalink
closes #570
Browse files Browse the repository at this point in the history
  • Loading branch information
ahwagner committed Dec 11, 2024
1 parent e007f2d commit 209b33f
Showing 1 changed file with 9 additions and 0 deletions.
9 changes: 9 additions & 0 deletions docs/source/conventions/computed_identifiers.rst
Original file line number Diff line number Diff line change
Expand Up @@ -259,6 +259,15 @@ For example, the identifier for the allele example under :ref:`digest-serializat
ga4gh\:VA.0AePZIWZUNsUlQTamyLrjm2HWUw2opLt\_
.. warning::

GA4GH Computed Identifiers are a key mechanism for globally unique federated identification of variants.
However, as described here, these identifiers are dependent upon the structure of the object from which
the identifier is constructed. Consequently, there is no guarantee that VRS computed identifiers will
remain stable across major version releases of VRS; for example, all VRS v1.x computed identifiers are
distinct from all VRS v2.x identifiers. It is recommended that implementers heed the maturity level of
data classes as defined by the :ref:`maturity-model` when gauging the stability of data classes–and
therefore object identifiers from thoses classes–across releases of VRS.

References
@@@@@@@@@@
Expand Down

0 comments on commit 209b33f

Please sign in to comment.