Skip to main content

Maintained resource

Things a space takes responsibility for: declaring them, namespaces and parts, who may do what, and shared definitions.

What a maintained resource is​

A maintained resource is something a space takes responsibility for and gives a page to: a vocabulary, a collection of documents, a set of documentation like this one, a systematic review, a shared template. The resource is identified by a URI; the space is what says who may work on it and what its page shows.

Declaring one is a single nanopublication by an admin of the space: the resource's URI, a name, a description, the space that maintains it, and optionally a type and a namespace. From then on the resource has a page hosted within the space.

Nanopublication · Open in Nanodash

Kinds of resource​

A resource can be typed to say what it is — an ontology, a concept scheme, a collection, a systematic review, an assertion template — and the type says which ready-made views suit its page, which the space then attaches: a vocabulary gets lists of its classes and terms and an action to release a version, for instance. A resource without a type is a plain page that its admins furnish with views of their choosing.

Nanopublication · Open in Nanodash

Namespace and parts​

A resource may declare a namespace: a URI prefix, such as https://w3id.org/spaces/example/r/vocabulary/, under which the things belonging to it are minted. Anything with a URI under that prefix is a part of the resource, and gets a page of its own, hosted within the resource's page, showing what the network knows about it.

A part's page is put together from the nanopublication that introduced it, which must have been published by a member of the space. Links to a part from anywhere on Nanodash lead to that page, so the namespace is also what makes a resource's terms, entries or paragraphs navigable rather than bare URIs.

Nanopublication · Open in Nanodash

Who may do what​

Declaring a resource, attaching views to its page and choosing its presets are for admins and maintainers of the space. Contributing to its content — defining a term, adding an entry, writing a paragraph — is for the space's members, and the pages of collaboratively edited resources show what members have contributed. Observers and outsiders can read everything but their contributions, though stored on the network, are not shown.

Nanopublication · Open in Nanodash

A resource as a shared definition​

A space can also list a template or a view as one of its maintained resources. The point is less to give it a page than to take charge of its versions: once the space maintains the template or view, the current version is the newest one published by any member of the space, rather than by whoever published the previous one. That is how a community keeps its shared tools current after their original author has moved on.

Nanopublication · Open in Nanodash

This page is a copy of the topic Maintained resource 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.