Vocabulary
Vocabularies as maintained resources: defining terms, approving them, changing them, and releasing versions.
What a vocabulary is here
A vocabulary is a set of defined terms — classes, properties, named individuals — that a community maintains together: the kinds of chemical entity a project works with, the concepts of a domain, the categories of a classification. On the network a vocabulary is a maintained resource of a space, typed as an ontology, with a namespace of its own under which its terms are minted.
Each term is its own nanopublication, signed by whoever defined it, so a vocabulary is not one document but a growing collection of small, individually attributable definitions. It is the most common kind of maintained resource on the network.
Defining a term
A term is defined with a form for its kind — class, property or individual — from the vocabulary's page. The form asks for a short name, which becomes the last part of the term's URI under the vocabulary's namespace, a label, a definition, and whatever is specific to the kind, such as the classes a new class falls under. The nanopublication records that the term belongs to the vocabulary.
A term can refer to terms of other vocabularies, on the network or elsewhere, wherever a relation to an existing concept is what is meant, rather than a new definition.
Approval of terms
A term defined by a member of the space is pending until it is approved. Approval comes in two ways: a member of the space publishes an approval of the term's nanopublication, or the term was published by a holder of the space's auto-approved role, which is how bulk imports and bots contribute without a person approving each term. A member can also disapprove a term, which sets it aside.
The vocabulary's page shows approved terms in its Classes and Terms lists, and pending ones separately with approve and disapprove actions, so the state of every term is visible and the decisions are recorded as nanopublications.
Changing a term
A term is revised by publishing a new version of its nanopublication, which keeps the term's URI. Anyone with a role in the space can do this, including for terms others defined; the vocabulary shows the newest approved version. Earlier versions remain on the network, and a term that was defined in error is retracted or disapproved rather than deleted.
Because the URI never changes, everything that referred to the term — other vocabularies, data, nanopublications elsewhere — keeps pointing at it through every revision.
Releasing a version
A vocabulary changes continuously, term by term. When a fixed reference is needed — for a publication, a dataset, a piece of software — the space releases a version: an index listing every approved term at that moment, with a version number and a page of its own that always shows exactly that set, whatever happens to the vocabulary afterwards.
Citing a version therefore means citing a specific, unchanging set of definitions, while citing the vocabulary itself means citing whatever is current.
This page is a copy of the topic Vocabulary of the Nanopublication Docs. Each paragraph is a nanopublication. In Nanodash you also find their examples, related paragraphs, and version history, and members of the nanopub space can edit them there.