Akoma Ntoso

Akoma Ntoso provides a hierarchical XML schema that captures the logical structure of legal documents rather than just their visual presentation. Key structural elements include:

• <debate>: Transcripts of parliamentary proceedings
• <judgment>: Judicial decisions with majority and dissenting opinions
• <bill>: Proposed legislation with amendment tracking
• <act>: Enacted statutes with section-level granularity

Each element carries metadata attributes for jurisdiction, date of enactment, and authoritative status, enabling precise document identification.

Akoma Ntoso adopts the Functional Requirements for Bibliographic Records (FRBR) model to distinguish between four conceptual layers of a legal document:

• Work: The abstract intellectual creation (e.g., a statute's conceptual content)
• Expression: The specific textual realization (e.g., the enacted version in English)
• Manifestation: The published format (e.g., the official gazette PDF)
• Item: The individual copy (e.g., a specific downloaded file)

This separation enables version control, language variants, and consolidation tracking across the entire lifecycle of a legal text.

The standard includes a robust named reference mechanism using eId attributes and ref pointers that create a navigable graph of legal citations. Core capabilities:

• Internal references: Links between sections, subsections, and paragraphs within the same document
• External references: Citations to other statutes, regulations, or case law using standardized identifiers like ELI (European Legislation Identifier)
• Pinpoint citations: References to specific paragraphs or clauses within a cited authority

This transforms static text into a computable citation network suitable for automated legal reasoning.

Akoma Ntoso natively models the temporal dimensions of legislation through dedicated metadata and inline markup:

• <amendment>: Marks text insertions, deletions, or substitutions with references to the amending act
• <mod>: Indicates modifications with type attributes for 'repeal', 'substitution', or 'insertion'
• Time attributes: date, start, and end attributes define when provisions are in force

This enables point-in-time reconstruction of a statute's text as it existed on any given date, critical for historical legal analysis.

The standard employs a generic metadata container (<meta>) with a name attribute that allows jurisdictions to extend the schema without breaking interoperability. Common metadata categories:

• Proprietary metadata: name="jurisdiction", name="docketNumber"
• Classification metadata: Subject matter taxonomies and keywords
• Provenance metadata: Workflow stages, approving bodies, and publication history

This extensibility ensures Akoma Ntoso can accommodate diverse parliamentary traditions while maintaining a common core for cross-jurisdictional tools.

Akoma Ntoso documents can contain parallel authoritative versions in multiple languages within a single XML instance. Key mechanisms:

• <component>: Wraps each language version with xml:lang attributes
• <attachment>: Houses alternative formats or translations
• Alignment markers: Enable sentence-level correspondence between language variants

This is essential for multi-lingual jurisdictions like the EU, Canada, and Switzerland, where all language versions carry equal legal force and must be analyzed in parallel.

The algorithmic task of identifying the precise start and end points of logical sections within a legal document, such as articles, recitals, or schedules. Section boundary detection is a prerequisite for mapping raw text to Akoma Ntoso's hierarchical structure.

• Uses token classification models for boundary prediction
• Handles nested section hierarchies
• Critical for automated document decomposition
• Enables accurate cross-reference targeting

The process of identifying section titles and subtitles and reconstructing the nested parent-child relationships that form the document's outline. Header hierarchy extraction directly maps to Akoma Ntoso's containment structure.

• Detects font-based and numbering-based hierarchy cues
• Reconstructs the document's logical outline
• Assigns depth levels to each heading
• Feeds into XML element nesting decisions

The task of assigning a functional label—such as title, recital, operative provision, or signature block—to a segmented block of text within a legal document. This classification determines which Akoma Ntoso element type wraps each content block.

• Distinguishes prefatory from binding content
• Identifies metadata blocks like dates and signatures
• Uses sequence labeling with BIO tagging schemes
• Enables semantic markup beyond raw structure

The process of computationally linking a textual reference pointer within a legal document to the specific target provision, section, or external authority it cites. Akoma Ntoso's reference element and naming conventions enable automated resolution.

• Parses statutory reference strings into components
• Resolves internal section references
• Links to external legal authorities via URIs
• Enables citation network construction

A uniform resource identifier standard for uniquely identifying judicial decisions from European courts and tribunals. ECLI complements Akoma Ntoso by providing a standardized citation layer for case law.

• Format: ECLI:[country]:[court]:[year]:[identifier]
• Enables cross-border legal research
• Integrates with Akoma Ntoso's FRBR naming model
• Facilitates citation verification systems