AKN4UN Document Classes
Document vs Logical Component
In day-to-day language, we use the term “document” to refer to many different things: an official record, a collection of different documents, a report, an official letter, etc. to list just a few. The dictionary definition of documents goes:
“any content whatever its medium (written on paper or stored in electronic form or as a sound, visual or audio-visual recording) that provides information or evidence or that serves as an official record”.
Here we are not particularly interested in the medium, instead we would like to make the distinction between what we call:
“Document”: the "physical" document as it appears to the readers in whatever medium it may be, whether on paper, electronic format, etc. Please note that here we use “document” in its more generic meaning of the action of making something generally known, by publishing it to an audience;
and
“Logical Component”: any logically and functionally distinct component of a “document”.
Let’s take the typical life-cycle of a resolution to explain this with a concrete example.
The first appearance of a resolution may be in a letter that the proponent sent to a deliberative body, or its members, to inform it of his/her intention to submit a resolution.
Subsequently, the resolution may be issued in a publication series as “draft resolution” or in documents of a different nature, e.g. committee reports.
When eventually the resolution is discussed in a deliberative body, if approved, it may be published as an adopted resolution in a publication series or in the official records of the relevant meeting.
In the last stage of a resolution life-cycle, it may be published in the official compilation and that may become its “authoritative version”.
The whole life-cycle of a resolution actually takes place through a series of “documents” in which the resolution takes different “forms” as you may see in the table below.
Table 7. Lifecycle of a Resolution
document | resolution | |
status | form | |
letter | proposed | attached to a submission letter |
publication | draft | in the body of a publication |
committee report | draft | in the body of a committee report |
draft | attached to a committee report | |
publication | adopted | in the body of a publication |
official records | adopted | in the body of a meeting report |
adopted | attached to a meeting report | |
official cumulation | authoritative | part of a collection of resolutions |
As we may see from the table above, the resolution, as a logical component, may appear in any of the following forms: in the body of the hosting document, as an attachments of a hosting document or as a component of a container of other documents, etc.
In order to trace the path of a resolution from its first draft till the end of its lifecycle, there is a need to make the very critical distinction between the “document”, as it appears to the readers, and the “logical component”, which is any functionally distinct component of a “document”.
The “logical resolution” is a structurally distinct component that persists across the different “documents” where a resolution may appear in its lifecycle, as we show in the table below.
Table: Lifecycle of a resolution: distinguishing between document and logical component
document | logical components | status | form | |
letter | letter | resolution | proposed | attached to |
publication | publication | resolution | draft | in the body of |
committee report | committee report | resolution | draft | in the body of |
resolution | draft | attached to | ||
publication | publication | resolution | adopted | in the body of |
official records | meeting report | resolution | adopted | in the body of |
resolution | adopted | attached to | ||
official cumulation | official records | resolution | authoritative | part of a collection |
The distinction between “document” and “logical component” is very critical and used throughout the Guidelines.
NOTE: In the context of these Guidelines “document” and “logical component” will be used to mean respectively “physical document as it appears to the readers in whatever medium it may be” and “any logically and functionally distinct component of a document”.
UN Document Classes
A survey of the different parliamentary, normative, judicial and official documents used by all participating organizations was carried out by the HLCM Working Group on Document Standards (WG) late in 2016.
The UN Document Classes are meant to represent different typologies of documents across their complete lifecycle by identifying commonalities and patterns in function and structure. The UN Document Classes do not aim to represent any specific typology of documents of an organization. They are designed to represent:
The core feature of UN document types. They are meant to describe classes of documents that, to a large degree, have the same function, play the same legal role and have the same content structure across UN organizations.
The whole lifecycle of documents, from when they were drafted until when its workflow has been completed in all its forms and not just a specific state.
The different UN Document Classes represent abstract typologies of documents because they do not refer to any specific stage of their workflow or specific publications form in which documents may be disseminated.
The Document Classes identified by the HCLM WG are listed in the table below.
Caveat: the definitions below are to be considered only as a general description with the sole purpose of providing an indication of the types of documents that may belong to each class and subclass.
Please see Annex I for a detailed list of AKN4UN Document Classes.
Table: UN Document classes identified by the HLCM-WG
Class | Subclass |
Normative Documents Formal provisions concerning commands, recommendations | charter | code of conduct | code of practice |constitution |convention |protocol |recommendation |rules |rules of procedure |regulation |treaty |standard |
Deliberative Documents Formal expressions of the opinion or will of a body | resolution | decision |
Administrative Issuances Formal instruction or notifications | administrative instruction | administrative circular |
Meeting Agenda Listing of agenda items of a meeting | agenda listing | annotated agenda |
Meeting Records Full first-person records of a meeting | meeting verbatim record |
Meeting Reports Summarized accounts of meetings | meeting minute | meeting report | conference report | council report |
Court Decisions Court of laws formal decision | judgment | order | advisory opinion| |
Communications Official communication | address | bulletin | circular | declaration | memoranda | note | official letter | official statement | press release | |
Papers Official document about a particular subject or accounts | policy | position paper | progress report | budgetary document |
Modificatory Instructions Formal proposals for modifications | amendment |
Publication Publication of standalone documents, authoritative compilation of official documents and collection documents | publication | official compilation | collection | amendment list |
Please note that “Publication Document Class” is essentially meant to be used as “container” of “logical components”. The subclass “publication” is used for standalone physical documents; while “official compilation” is meant for document containing several authoritative versions of documents, and “collection” is more a kind of “folder” containing even quite different documents.
Mapping of AKN4UN Document Classes to AKN Document Types
Before we go through the list of AKN documentTypes we have to keep in mind that, in Akoma Ntoso, documentTypes have the following properties:
They are abstract categories, like UN Document Classes. They do not model any specific document, but only categories of documents that share broadly the same functions, legal roles and content structures.
Their names are just labels, and do not have to be taken literally. For example, the AKN documentType <act> is not meant to model only “acts”, but all documents that are considered normative and structured in hierarchies.
They uniquely identify different types of documents via the attribute @name, e.g. <act name=”{local name}”>.
NOTE: AKN4UN Document Classes are meant to model “logical components” that make up a physical document. Physical documents may so be modelled by one or more AKN4UN Document Classes.
The table below presents the correspondence between the UN Document Classes and the Akoma Ntoso documentTypes. An AKN4UN compliant document must use:
The mandatory documentType, which must be set to one of the prescribed values indicated in the table below.
The mandatory @name in all document type elements. The value of the attribute @name is left open for the individual organization to choose what best fits the name of their specific document. The list below should be considered only as indicative but every effort should be made to keep it updated and when possible reuse existing values.
The mandatory subtype value, which must be set to one of the prescribed values as indicated in the table below, to be used as value of <FRBRSubType> and for the subtype component of document IRI.
For example, a treaty document type would be:
<act name=”treaty”> while its document IRI would be /akn/{jurisdiction}/act/provision/{actor}/{date}/{docNumber}
See AKN4UN Naming Convention section for more details.
Mapping of UN Document Classes to AKN Document Types
UN Document | AKN | AKN4UN | UN Document | AKN4UN |
class | documentType | subtype | sub-class | @name mandatory |
value is prescribed | value is suggested | |||
Normative Documents: | <act> <bill> | provision | charter | charter |
code of conduct | codeOfConduct | |||
code of practice | codeOfPractice | |||
constitution | constitution | |||
convention | convention | |||
protocol | protocol | |||
recommendation | recommendation | |||
rules | rules | |||
rules of procedure | rulesOfProcedure | |||
regulation | regulation | |||
treaty | treaty | |||
standard | standard | |||
Deliberative Documents: | <statement> | deliberation | resolution | resolutionDraft |
resolution | ||||
decision | decisionDraft | |||
decision | ||||
Administrative Issuances: | instruction | administrative instruction | administrativeInstruction | |
administrative circular | administrativeCircular | |||
Meeting Agenda: | <debateReport> | agenda | agenda listing | agendaListing |
annotated agenda | agendaAnnotated | |||
Meeting Records: | <debate> | record | verbatim record | verbatimRecord |
Meeting Reports: | <debateReport> | minute | meeting minute | meetingMinute |
report | meeting report | meetingReport | ||
conferenceReport | ||||
councilReport | ||||
Court Decisions | <judgment> | decision | judgment | judgment |
order | order | |||
advisory opinion | advisoryOpinion | |||
Papers: | <doc> | paper | policy | Policy |
position papers | positionPaper | |||
progress report | progressReport | |||
budgetary document | budgetaryDocument | |||
Communications: | communication | address | address | |
bulletin | bulletin | |||
circular | circular | |||
declaration | declaration | |||
memoranda | memoranda | |||
note | note | |||
official letter | officialLetter | |||
official statement | officialStatement | |||
press release | pressRelease | |||
Modificatory instructions | <amendment> | modification | amendment | amendment |
Publications: | <documentCollection> | publication | publication | publication + doc type e.g. publicationResolution |
collection | collection + doc type | |||
<officialGazette> | official compilation | officialCompilation + doc type | ||
<amendmentList> | amendments list | amendmentList |