...
- Any Web document can create a standard Web linnk link directly to the ToIP Glossary as a whole or to any specific term within it.
- Any other Spec-Up-based specification can create an xref (external reference) to a term. An xref is more than just a link—it enables the Web version of the document to display a pop-up definition of the term when you hover the link with your mouse cursor.
...
The challenge with permalinks to the ToIP Glossary is that it is a living document. Definitions of terms may evolve over time. After much discussion, the CTWG concluded that this meant means two classes of permalinks must be supported:
...
https://trustoverip.github.io/glossary/yyyymmdd
Where “yyyymmdd” yyyymmdd
is the date string consisting of the year—and optionally the month and day—of the version following these rules:
- The
yyyy
string MUST be present. - The
yyyy
string MAY OPTIONALLY be followed by EITHER a “mmdd”mmdd
string OR a “mm”mm
string.
The returned version of the ToIP Glossary MUST be the union of the definitions of all terms that existed in the living ToIP Glossary as of the last datetime equal to or earlier than the date string.
...
https://trustoverip.github.io/glossary/vxx
Where “xx” xx
is the version number of the version following these rules:
- The
xx
string MUST be present. - The
xx
string MUST be a positive integer. - The
xx
string MUST NOT have leading zeros, e.g., it must start at 1. - The vxx
xx
string MUST be incremented by one for each new version tag, e.g., v1, v2, v3…v439.
...