Modelling/Documents

 Modelling

Documents — Index terms — Humans — Events and activities (Conferences) — Projects — Content uploads (Resource types)

Modeling a document

There are many possible types of document (Q21). See the list of available types.

When a new document type is needed, it should have subclass of (P4) = document (Q21) (see white paper (Q47)), or subclass of (P4) = more specific type (see final report (Q76) which is a type of report (Q29)).

Document types are expected to have a same as on Wikidata (P1), though special cases that are not relevant for Wikidata are imaginable.

Linking topics and projects

A document should have one or more main subject (P15) to describe what it's about, e.g. linked open data (Q70). The value of this statement can be an index term (Q12) (topical keyword), an activity/event (a report from an edit-a-thon), a project (a report from a project), an organization, a Wikimedia content project (Q22)...

The more subject keywords we add, the easier it becomes to run nuanced searches and analyses.

A document that was produced within the scope of a particular project, as is the case with documents produced by WMSE, should link to this project with produced in the scope of the project (P36).

Note that documents like application (Q43), which are directly related to a particular project, but were not created during this project, will have the project as main subject (P15) but not as produced in the scope of the project (P36) (because an application is published before the project has started).

Example items

• Final report: Strategic Inclusion of Library Data in Wikidata 2018 ‒ final report (Q35)
• White paper: WMSE white paper on Structured Data on Commons (Q89)
• Application: Strategic Inclusion of Library Data in Wikidata 2018 ‒ application (Q74)
• Poster: Wikidata as an open, collaborative bibliographic database: the case of the National Library of Sweden (Q45)

Properties used

Required	Property	Example value	Notes
IF EXISTS	same as on Wikidata (P1)	Q12323	If a document is relevant for Wikidata (e.g. a scholarly article) and has an item there.
REQUIRED	instance of (P5)	report (Q29)	See all available types of documents
REQUIRED	main subject (P15)	Wikidata (Q20)
REQUIRED	title (P8)	Wikidata as an open, collaborative bibliographic database: the case of the National Library of Sweden
	language of work or name (P20)	English (Q32)
	publication date (P18)	31 July 2019	If no specific date can be identified, month or year is enough
	addressee (P29)	National Library of Sweden (Q75)	For grant applications, open letters and similar documents with a specific recipient
	publisher (P21)	Wikimedia Sverige (Q9)
	author (P19)	Axel Pettersson (Q77)
	part of (P17)	Strategic Inclusion of Library Data in Wikidata 2018 ‒ final report (Q35)	For documents that have several parts which are so clearly identifiable that they can get own items, e.g. chapters in an anthology.
	has part(s) (P35)	Q96	For documents that have several parts which are so clearly identifiable that they can get own items, e.g. chapters in an anthology.
	produced in the scope of the project (P36)	Wikidata for authority control (Q14)	Connects the document with the project (Q2) it was produced for. Note that a document that describes a project (and thus has it as main subject (P15)) can be created after the project has ended, and thus formally "belong" to another project's scope.
	document file on Wikimedia Commons (P22)	LIBER 2020 Poster WMSE.pdf
	described at Wikimedia-page (P11)	:wmse:Projekt:Strategisk_inkludering_av_biblioteksdata_på_Wikidata_2018/Rapportering/Inklusionsguide	Link to a Wikimedia page where the project is described, using an interwiki prefix.
	created for (P46)	Q21991	Indicate if the document was created specifically to be used in a particular event or the like.
	P....... (P.......)	.......	........
	P....... (P.......)	.......	........
	P....... (P.......)	.......	........
	P....... (P.......)	.......	........

SPARQL

Find all documents:

PREFIX wb: <https://metabase.wikibase.cloud/entity/>
PREFIX wbt: <https://metabase.wikibase.cloud/prop/direct/>
SELECT ?item ?itemLabel ?instance_of ?instance_ofLabel ?published
WHERE
{
?item wbt:P5/wbt:P4* wb:Q21.
?item wbt:P5 ?instance_of.
OPTIONAL {?item wbt:P18 ?published.}
SERVICE wikibase:label { bd:serviceParam wikibase:language "sv,en". }
}

Try it!

See also

• Document Cradle and Entity Schema.