{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.tr.document-indexing","code":"thing-q1167863","url":"https://ver.cy/models/thing/q1167863/","name":"document indexing","alternateNames":[],"kind":"thing","status":"published","version":"0.1.0-research.1","language":"en","classifiers":{"family":"Thing Registry","category":"Activities and processes","entryKind":"thing","plane":"ACT","domain":["ACT.ACT"],"industry":[],"navPath":"","tags":[],"facets":{}},"whatItIs":"Document indexing is the activity of classifying a document by assigning or selecting keywords, index terms or descriptors that represent its subject content and support identification and retrieval.","purpose":"Enable an AI agent to recognise document indexing, assess whether assigned keywords, index terms or descriptors represent a document appropriately, and decide when those assignments need review or revision.","scope":{"in":["The retrieval purpose, intended users and document boundaries that guide term assignment are in scope.","Assessment of document subjects and selection or extraction of representative terms are in scope.","Keywords, index terms, subject headings and descriptors assigned to documents are in scope.","Human, automated and hybrid term assignment, including review and correction, is in scope.","Term coverage, retrieval evaluation and synchronisation with document changes are in scope."],"out":["Document authorship, substantive editing and publication are outside this model.","Scanning, transcription and optical character recognition are outside this model except for their effects on term assignment.","General collection cataloguing and records management beyond subject term assignment are outside this model.","Query processing, result ranking and search-interface design are outside this model except as requirements or evaluation contexts.","Database performance indexes that accelerate storage access are outside this model.","Vector indexing and full-text indexing without document classification by selected terms are outside this model.","Back-of-book indexes and other navigation to locations within documents are outside this model."],"boundaries":[]},"distinguishingFeatures":["The activity assigns or maintains keywords, index terms or descriptors that classify a document by its subject content.","The indexed unit is a document whose subject content is represented by the selected terms.","Terms may come from a controlled vocabulary or be selected as free keywords.","A summary can inform term selection, but summarisation alone does not establish document indexing.","Automated methods belong here when they select or assign classification terms to documents.","Vector representations, hyperlinks and within-document locators alone do not establish document indexing in this sense."],"structure":{"bundles":[{"id":"retrieval-purpose-and-boundaries","name":"Retrieval purpose and boundaries","description":"Establishes what users need to find and which document units the indexing activity represents.","layers":[{"id":"retrieval-tasks","name":"Retrieval tasks","description":"Connects indexing choices to intended information-seeking tasks.","findings":[{"id":"intended-retrieval-outcome","name":"Intended retrieval outcome","description":"Record whether indexing supports subject discovery, known-item lookup, passage retrieval, within-document navigation or a declared combination.","questions":[{"text":"What must a user or agent be able to find through this indexing activity?","id":"intended-retrieval-outcome-q01","kind":"definition"},{"text":"Which representative retrieval tasks will be used to judge whether the chosen indexing mode is suitable?","id":"intended-retrieval-outcome-q02","kind":"measurement"}]}]},{"id":"document-and-unit-selection","name":"Document and unit selection","description":"Defines inclusion boundaries and the unit to which an indexing representation attaches.","findings":[{"id":"eligible-content-boundary","name":"Eligible content boundary","description":"Record document versions, target granularity and treatment of attachments, tables, illustrations, notes and duplicate copies.","questions":[{"text":"Is each retrieval representation attached to a whole document, a structural section, a page or a generated passage?","id":"eligible-content-boundary-q01","kind":"boundary"},{"text":"Which content is deliberately excluded, and how are those exclusions distinguished from indexing failures?","id":"eligible-content-boundary-q02","kind":"boundary"}]}]}]},{"id":"content-analysis-and-representation","name":"Content analysis and representation","description":"Describes how document content becomes a representation usable for retrieval.","layers":[{"id":"indexable-content-preparation","name":"Indexable content preparation","description":"Records the content actually available to the indexing method and transformations that affect its meaning or boundaries.","findings":[{"id":"representation-input","name":"Representation input","description":"Identify source fields or passages and relevant extraction, language handling, normalisation and segmentation choices.","questions":[{"text":"Which source fields or passages were available for indexing, and which extraction failures reduced that input?","id":"representation-input-q01","kind":"provenance"},{"text":"How do tokenisation, passage boundaries or language-specific transformations affect what can be retrieved?","id":"representation-input-q02","kind":"boundary"}]}]},{"id":"representation-assignment","name":"Representation assignment","description":"Captures how terms, headings, fields or learned representations are selected and attached to content.","findings":[{"id":"assignment-policy","name":"Assignment policy","description":"Record whether representations are extracted, interpreted or generated, with their specificity and supporting content.","questions":[{"text":"What rule determines whether a concept receives an entry, including concepts discussed without being named explicitly?","id":"assignment-policy-q01","kind":"definition"},{"text":"Which source content and indexing method support this assigned heading, term or machine representation?","id":"assignment-policy-q02","kind":"provenance"}]}]}]},{"id":"index-organisation-and-addressing","name":"Index organisation and addressing","description":"Captures the structures through which retrieval representations lead to the appropriate content.","layers":[{"id":"vocabulary-and-entry-relations","name":"Vocabulary and entry relations","description":"Records semantic and navigational relationships where the indexing mode exposes terms or headings.","findings":[{"id":"term-identity-and-cross-references","name":"Term identity and cross-references","description":"Represent preferred terms, variants, ambiguous labels, subentries and cross-references when applicable.","questions":[{"text":"How are synonyms, spelling variants and identical labels with different meanings handled?","id":"term-identity-and-cross-references-q01","kind":"definition"},{"text":"Which cross-references or heading relationships must be checked for missing targets, misleading equivalence or circular navigation?","id":"term-identity-and-cross-references-q02","kind":"action"}]}]},{"id":"retrieval-target-addressing","name":"Retrieval target addressing","description":"Connects entries or machine representations to resolvable document identities and locations.","findings":[{"id":"locator-integrity","name":"Locator integrity","description":"Record the locator scheme and the document version against which addresses are valid.","questions":[{"text":"Does this representation resolve to a document identifier, page reference, anchor or passage identifier, and against which version?","id":"locator-integrity-q01","kind":"provenance"},{"text":"What proportion of tested locators reaches the intended content rather than merely an existing destination?","id":"locator-integrity-q02","kind":"measurement"}]}]}]},{"id":"indexing-execution-and-maintenance","name":"Indexing execution and maintenance","description":"Records responsibility for indexing decisions and keeps retrieval representations aligned with changing documents.","layers":[{"id":"assignment-and-review-workflow","name":"Assignment and review workflow","description":"Identifies the people or methods that produced representations and the review required for their intended use.","findings":[{"id":"indexing-decision-trace","name":"Indexing decision trace","description":"Associate indexing outputs with responsible indexers or processing configurations and any review decisions.","questions":[{"text":"Which indexer or automated configuration produced these entries, using which vocabulary or model version?","id":"indexing-decision-trace-q01","kind":"provenance"},{"text":"Which ambiguous assignments or processing failures require human review before acceptance?","id":"indexing-decision-trace-q02","kind":"action"}]}]},{"id":"change-propagation","name":"Change propagation","description":"Determines how document and policy changes trigger indexing updates.","findings":[{"id":"affected-entry-maintenance","name":"Affected-entry maintenance","description":"Track entries affected by revision, deletion, relocation, access changes or replacement of an indexing method.","questions":[{"text":"Which changes require updating a locator, reassessing assigned concepts or regenerating the complete representation?","id":"affected-entry-maintenance-q01","kind":"action"},{"text":"How are stale entries and representations of withdrawn or newly restricted content identified and removed from applicable retrieval paths?","id":"affected-entry-maintenance-q02","kind":"action"}]}]}]},{"id":"indexing-quality-and-retrieval-evidence","name":"Indexing quality and retrieval evidence","description":"Assesses completeness, representational validity and usefulness under declared retrieval conditions.","layers":[{"id":"coverage-and-representation-audit","name":"Coverage and representation audit","description":"Checks missing units, unsupported assignments and inconsistent treatment of comparable content.","findings":[{"id":"coverage-and-assignment-defects","name":"Coverage and assignment defects","description":"Separate processing coverage from the adequacy and support of assigned representations.","questions":[{"text":"How many eligible documents or content units lack a usable indexing representation?","id":"coverage-and-assignment-defects-q01","kind":"measurement"},{"text":"Which sampled entries misrepresent the source, omit important concepts or apply the indexing policy inconsistently?","id":"coverage-and-assignment-defects-q02","kind":"measurement"}]}]},{"id":"retrieval-task-evaluation","name":"Retrieval task evaluation","description":"Tests the index through representative information needs while recording the surrounding retrieval configuration.","findings":[{"id":"fitness-for-retrieval","name":"Fitness for retrieval","description":"Connect evaluation results to specific indexing choices and distinguish indexing defects from downstream retrieval effects.","questions":[{"text":"Which query or navigation tasks, relevance judgements and success measures establish fitness for the intended users?","id":"fitness-for-retrieval-q01","kind":"measurement"},{"text":"What evidence attributes a failed retrieval task to indexing rather than query interpretation, ranking, permissions or interface behaviour?","id":"fitness-for-retrieval-q02","kind":"boundary"}]}]}]},{"id":"evidence-and-external-alignment","name":"Evidence and external alignment","description":"What the world already says about this thing, gathered so the model can be checked against it.","layers":[{"id":"reported-evidence","name":"Reported evidence","description":"Findings from the breadth pass, kept separate from the structural claims.","findings":[{"id":"evidence-confidence-notes","name":"Check these first","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these check these first hold for the sense of document indexing this model covers, and on what evidence?","id":"evidence-confidence-notes-q01","kind":"provenance"}]},{"id":"evidence-kinds","name":"Kinds and varieties","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these kinds and varieties hold for the sense of document indexing this model covers, and on what evidence?","id":"evidence-kinds-q01","kind":"provenance"}]},{"id":"evidence-standards-and-regulation","name":"Standards and regulation","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these standards and regulation hold for the sense of document indexing this model covers, and on what evidence?","id":"evidence-standards-and-regulation-q01","kind":"provenance"}]},{"id":"evidence-real-world-use","name":"Real-world use","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these real-world use hold for the sense of document indexing this model covers, and on what evidence?","id":"evidence-real-world-use-q01","kind":"provenance"}]},{"id":"evidence-measurements","name":"Typical measurements","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these typical measurements hold for the sense of document indexing this model covers, and on what evidence?","id":"evidence-measurements-q01","kind":"provenance"}]},{"id":"evidence-failure-modes-and-hazards","name":"Failure modes and hazards","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these failure modes and hazards hold for the sense of document indexing this model covers, and on what evidence?","id":"evidence-failure-modes-and-hazards-q01","kind":"provenance"}]},{"id":"evidence-regional-variation","name":"Regional variation","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these regional variation hold for the sense of document indexing this model covers, and on what evidence?","id":"evidence-regional-variation-q01","kind":"provenance"}]},{"id":"evidence-neighbours","name":"Neighbouring kinds and how to tell them apart","description":"Recalled without web access and unsourced; every item is a lead to verify.","questions":[{"text":"Which of these neighbouring kinds and how to tell them apart hold for the sense of document indexing this model covers, and on what evidence?","id":"evidence-neighbours-q01","kind":"provenance"}]}]}]}]},"agentConduct":{"may":["Classify documents the agent is authorised to read using keywords, index terms or descriptors.","Assign subject descriptors following a stated vocabulary or standard."],"mustNot":["Index documents the agent is not authorized to access.","Expose confidential or personal content through search results.","Drop documents from an index in a way that hides them from legal discovery.","Apply biased or offensive subject terms to people or groups."],"requiresHuman":["Making a private collection searchable to a wider audience requires human review."]},"ethics":{"considerations":["Indexing decides what can be found; omissions and labels shape knowledge.","Search can expose private data."],"affectedParties":["People named in documents","Users of the collection"]},"owners":{"steward":"The owner of the collection.","roles":[],"masterSystems":[]},"relations":[{"target":"Q11977025","type":"parent","note":"registry parent class"},{"target":"Q2210408","type":"parent","note":"registry parent class"}],"interaction":{"identity":{"applicability":"required","items":["Vercy registry: vr.tr.document-indexing","Wikidata: Q1167863 (https://www.wikidata.org/wiki/Q1167863)"]},"properties":{"applicability":"not-applicable","items":["Indexing mode: Subject indexing; within-document indexing; full-text indexing; vector indexing; hybrid; other declared mode","Retrieval target granularity: Document; section; page; paragraph; passage; other declared unit","Indexed document version: Link between an indexing result and the document version or content snapshot it represents","Representation basis: Controlled vocabulary; free terms; extracted tokens; structured fields; learned representations; combination","Eligible-unit coverage: Percentage of declared eligible document units successfully indexed, with denominator and exclusions recorded","Index freshness lag: Elapsed time between a relevant document change and its incorporation into the index","Review state: Unreviewed; under review; accepted for declared use; correction required; superseded","Retrieval evaluation result: Metric name and value with query set, relevance judgements, index version and retrieval configuration"]},"recognition":{"applicability":"not-applicable","items":[]},"capabilities":{"applicability":"required","items":["Declare which documents and content units should be indexed for a specified retrieval purpose.","Generate or assign retrieval representations using a declared indexing policy.","Inspect index entries against source passages and correct unsupported or misleading representations.","Validate locators, cross-references and coverage before accepting an indexing result.","Compare indexing alternatives against representative retrieval tasks.","Identify and update or remove entries affected by document revision, withdrawal or access changes."]},"hazards":{"applicability":"required","items":["Incorrect or incomplete indexing can hide relevant documents or retrieve misleading material.","Biased descriptors can misrepresent people or subjects and systematically distort discovery.","Searchable metadata can expose sensitive information even when the underlying document has restricted access.","Outdated index entries can direct users or agents to superseded or unavailable records."]},"interfaces":{"applicability":"required","items":["ISO 5963, Documentation - Methods for examining documents, determining their subjects, and selecting indexing terms, International Organization for Standardization."]},"context":{"applicability":"required","items":["Document indexing is used in libraries, archives, search systems and organizational records management to make documents discoverable.","It connects document content with search terms or controlled descriptors so users and agents can retrieve relevant material."]}},"sources":[{"title":"Wikidata item Q1167863: document indexing","url":"https://www.wikidata.org/wiki/Q1167863","note":"identity and sense of the item"},{"title":"Wikipedia: Subject indexing","url":"https://en.wikipedia.org/wiki/Subject_indexing","note":"general description of the item"}],"openQuestions":["Does the registry intend document indexing to encompass subject indexing, back-of-book indexing and automated search indexing, or does an existing registered or world-model concept own part of that scope?","Which authoritative indexing traditions and sources should establish the definitions and applicability of specificity, exhaustivity and consistency for each included mode?","How should the model assess evidence for learned retrieval representations whose relationship to individual document concepts is not directly inspectable?","Which retrieval tasks, relevance judgements and acceptance thresholds are appropriate for the intended document collections and users?","Where should responsibility lie for removing sensitive content from retrieval representations, including snippets and embeddings, when source-document access changes?"],"resources":{"spec":"/models/things/publications/thing-q1167863/spec.json"},"provenance":{"origin":"thing registry research (pass 2)","builtFrom":["models/things/publications/thing-q1167863/spec.json"],"providers":["Codex"],"researchStatus":"unreviewed","generatedAt":"2026-09-12T09:16:30Z","builder":"tools/build_cards.py@1.0.0"},"completeness":{"sections":{"classifiers":"filled","whatItIs":"filled","purpose":"filled","distinguishingFeatures":"filled","structure":"filled","agentConduct":"filled","ethics":"filled","owners":"filled","relations":"filled","interaction.identity":"filled","interaction.properties":"not-applicable","interaction.recognition":"not-applicable","interaction.capabilities":"filled","interaction.hazards":"filled","interaction.interfaces":"filled","interaction.context":"filled","sources":"filled"},"notes":{"_gate":"Published through the thing publication gate 1.0 on 2026-10-07T12:16:28+00:00: completeness 1.00; sense: Wikidata description; 2 live sources; review by codex: pass","interaction.properties":"Plane ACT: no invented physical properties.","interaction.recognition":"Document indexing is an activity whose identity cannot be established from visual appearance alone."},"score":1.0}}