Author
Dorian Taylor
Version
0.11
Created
January 23, 2012
Updated
December 11, 2012
February 6, 2014
February 8, 2015
April 6, 2017
October 6, 2018
March 5, 2019
April 7, 2019
April 17, 2019
July 7, 2019
July 10, 2019
July 21, 2019
September 4, 2019
Namespace URI
https://privatealpha.com/ontology/content-inventory/1#
Preferred Namespace Prefix
ci

This vocabulary defines a number of concepts peculiar to content strategy which are not accounted for by other vocabularies.

Such vocabularies include, but are far from limited to:

Classes

There are currently only three classes in this vocabulary, as other vocabularies account for all other constructs.

Action

An action, as its name implies, is meant to represent something a person or other agent ought to do to a document.

Being a subclass of an event, a ci:Action can have agents, factors, products, places and times ascribed to it.

Subclass of:
ev:Event

Back to Top

Audience

An audience represents the set of people who are the intended recipients of the resource. This class is at once an agent class as well as a conceptual entity, capable of being mixed into a SKOS concept scheme.

Subclass of:
dct:AgentClass
skos:Concept
See Also:
dct:audience
org:Role

Back to Top

Merge

In order to merge a document, we must define the target to which it ought to be merged. This class is identical to an Action, save for such a property.

Subclass of:
ci:Action

Back to Top

Properties

Authorial/Editorial Intent

desired-outcome

This property is intended to indicate what the document is supposed to do—what material effect it is supposed to produce. It is intentionally open-ended, and as such can point to something like a skos:Concept, another document, or a literal string of text describing the outcome.

Domain:
foaf:Document
Sub-property of:
dct:type

Back to Top

non-audience

This property complements dct:audience insofar as enabling the author or editor to designate a set of entities who are explicitly not the intended audience of the document.

Domain:
foaf:Document
Range:
dct:AgentClass
See Also:
dct:audience

Back to Top

Editing Tasks

action

use this to signal an action to take with the document in question.

Domain:
foaf:Document
Range:
ci:Action
Sub-property of:
ev:factor_of

Back to Top

target

Specify the URI of the target resource into which this document should be merged.

Domain
ci:Merge
Range
foaf:Document

Back to Top

Conceptual Relations

The purpose of these properties is to provide an interface to concept schemes created in SKOS. Relations created through the use of these properties will enable searching, filtering and partitioning sets of documents based on what they talk about.

mentions

The document explicitly mentions this concept.

Domain:
foaf:Document
Range
skos:Concept
Sub-property of:
dct:references

Back to Top

introduces

The document defines, describes, or otherwise introduces the audience to this concept.

Domain:
foaf:Document
Range
skos:Concept
Sub-property of:
ci:mentions

Back to Top

assumes

The document assumes the audience is familiar with this concept, and may not mention it explicitly.

Domain:
foaf:Document
Range
skos:Concept
Sub-property of:
dct:references
See Also:
dct:educationLevel

Back to Top

Audience Properties

aware-of

This property relates an Audience to a SKOS concept that is likely to be in the orbit of the audience's members: they are aware that the concept exists, although they may not necessarily understand it.

Domain:
ci:Audience
Range
skos:Concept
Sub-property of:
skos:related

Back to Top

understands

This property relates an Audience to a SKOS concept that members of the audience are known to comprehend, and thereby do not need any additional explanation.

Domain:
ci:Audience
Range
skos:Concept
Sub-property of:
ci:aware-of
See Also:
dct:educationLevel

Back to Top

values

This property relates an Audience to a SKOS concept that members of the audience are known to value, that is, to find meaningful in an axiological sense.

Domain:
ci:Audience
Range
skos:Concept
Sub-property of:
skos:related
See Also:
ci:eschews

Back to Top

eschews

This property relates an Audience to a SKOS concept that members of the audience are known to actively avoid or regard with contempt. This relation is intended to represent the complement of values.

Domain:
ci:Audience
Range
skos:Concept
Sub-property of:
skos:related
See Also:
ci:values

Back to Top

Content Management Metadata

embed

This property specifies an embedded resource which is visible in the subject's user interface.

Domain:
foaf:Document
Sub-property of:
dct:hasPart

Back to Top

alias

Denotes an alternate URI for the subject resource. It extends owl:sameAs insofar as asserting that the object is somehow less canonical than the subject.

Sub-property of:
owl:sameAs
Inverse of:
ci:alias-for

Back to Top

alias-for

Denotes that the subject is the alias URI, and the object is more canonical (though not necessarily the most canonical).

Sub-property of:
owl:sameAs
Inverse of:
ci:alias
See also:
ci:canonical

Back to Top

canonical

Asserts the canonical URI of the subject resource, i.e., the one you always want to publish in content or redirect Web requests to.

Sub-property of:
ci:alias

Back to Top

slug

The slug is a text token which represents either the full path or terminal path segment of an HTTP(S) URL by which a resource can be located. This property is mainly for the purpose of archiving old or alternative URL paths in a content inventory, for such tasks as generating URL rewriting maps.

Range
xsd:string

Back to Top

canonical-slug

This is the canonical slug associated with the resource, and should be populated with the slug which is actually in use.

Sub-property of:
ci:slug
Range
xsd:string

Back to Top

indexed

This is a boolean value to indicate whether or not a resource ought to be indexed. It does not necessarily ascribe a policy: an absence of an explicit true value does not necessarily imply the resource ought not be indexed, but the presence of a false value probably should.

Range
xsd:boolean

Back to Top

Individuals

This document defines a set of values useful for describing the status of documents and actions to take with them.

Statuses

The following bibo:DocumentStatuses are supplied in addition to the statuses specified by the Bibliography Ontology.

empty

The document contains no content.

Back to Top

incomplete

The document has been started, but is clearly not finished.

Back to Top

incorrect

The content of this document is factually wrong.

Back to Top

obsolete

The content of this document was correct and relevant at one point, but external circumstances have caused it to lapse in relevance or factual accuracy.

Back to Top

landing

The resource is a landing page from some other medium (e.g. e-mail, television, billboard). This status is a hint to automated systems which would otherwise orphan or retire a landing page with no inbound links.

Back to Top

orphan

The resource is not explicitly pending or removed from publication, however it has managed to be disconnected from the rest of the site: There is no path to it from a landing page, and it is not a landing page on its own. That is to say that the resource either has no inbound links, or if it does, those links are from other resources that are in the same situation. Documents which are only linked from retired documents are also considered orphans.

Back to Top

confidential

The document is confidential and not for publication.

Back to Top

circulated

The document is available for select people to see, but not published in the strict literal sense.

Back to Top

retired

The document has been explicitly retired by an editor or curator, but still exists in the archive.

Back to Top

unavailable

The resource at the subject address is unavailable for reasons other than explicit retirement, e.g. HTTP 404 or 403, or going out of print.

Back to Top

Actions

The following is a list of ci:Actions to be used with the ci:action property.

keep

Keep this document to which this is associated; make no changes to it at this time.

Back to Top

split

Split this document into multiple pieces.

Back to Top

tentative-merge

Merge this document into some other document, though unspecified at this time as to which.

Back to Top

update-metadata

Update the metadata of this document, such as keywords, audience, etc.

Back to Top

proofread

Proofread this document.

Back to Top

revise

Revise or restructure this document.

Back to Top

rewrite

Rewrite this document from scratch.

Back to Top

retire

Remove all references to this document and consign it to the archive.

Back to Top

Quantitative Metrics

There are many ways to measure a set of Web pages that give valuable insight into not only the individual character of each page, but also the character of an entire site.

We use the RDF Data Cube vocabulary to specify the quantitative metrics we gather over our documents.

Data Structure Definitions

The following object is an instance of qb:DataStructureDefinition. It depicts the dimensions, measures and attributes for qb:DataSets that carry the relevant statistical data. (This particular data structure only contains dimensions and measures.)

words-and-blocks

A set of descriptive statistics pertaining to the number of words per block of text in a given document.

Components
Dimensions
Counts
Five-number summary
Mean and Standard Deviation

Dimensions

The set of all qb:DimensionProperties for a given data structure can positively identify an observation. We currently only specify one dimension, the URI of the document in question.

document

Document Reference

Domain
qb:Observation
Range
foaf:Document

Back to Top

The qb:MeasureProperties are what define the data observed in a qb:Observation. Here we are interested in a five-number summary, along with the mean and standard deviation of block sizes (in words) found in a given document.

Measures

sections

For document types that have a concrete representation of sections, this property may be used to capture their sum.

Domain
foaf:Document
Range
xsd:nonNegativeInteger

Back to Top

blocks

A block count is conceptually similar to a word or section count, though it counts the total of elements in the document considered to be text blocks, such as paragraphs, tables, lists and figures. It is suited for document types that have no concept of (semantic) sections, such as HTML. The purpose of this measurement is to provide a sort of ratio to the word count, to glean how well-proportioned the document is.

Domain
qb:Observation
Range
xsd:nonNegativeInteger

Back to Top

words

This indicates the number of words in a document, similar to the familiar function in a word processor. The exact method of counting words may vary by document type, language etc., and is thus out of scope from this document.

Domain
qb:Observation
Range
xsd:nonNegativeInteger

Back to Top

characters

This indicates the number of characters in a document, with punctuation and the XPath normalize-space function applied. Note this is characters, not bytes.

Domain
qb:Observation
Range
xsd:nonNegativeInteger
See Also
normalize-space in the XPath 1.0 specification

Back to Top

outdegree

The number of links emanating from the specified resource.

Domain
qb:Observation
Range
xsd:number
See Also
Directed graph (Wikipedia)

Back to Top

indegree

The number of links pointing at the specified resource.

Domain
qb:Observation
Range
xsd:number
See Also
Directed graph (Wikipedia)

Back to Top

min

The smallest observation in the sample.

Domain
qb:Observation
Range
xsd:number
See Also
Sample minimum (Wikipedia)

Back to Top

low-quartile

Equivalent to the bottom quarter, or 25th percentile, of the observed data.

Domain
qb:Observation
Range
xsd:number
See Also
Quartile (Wikipedia)

Back to Top

median

The median of a population

Domain
qb:Observation
Range
xsd:number
See Also
Median (Wikipedia)

Back to Top

high-quartile

Third Quartile

Domain
qb:Observation
Range
xsd:number
See Also
Quartile (Wikipedia)

Back to Top

mean

Mean

Domain
qb:Observation
Range
xsd:number
See Also
Mean (Wikipedia)

Back to Top

sd

Standard Deviation

Domain
qb:Observation
Range
xsd:number
See Also
Standard deviation (Wikipedia)

Back to Top

This document is copyright 2010-2012 Dorian Taylor, available under a Creative Commons Attribution 2.5 Canada license, where attribution is defined as a link here.