Distributed Text Services Specifications

Manual Changelog 2026-02-04 Fixed (Issue 271) to have extensions and dublinCore be nested JSON LD properties Clarification on the fact that Citation Trees without a reference represent the same document. 2025-07-11 : 1.0 Release Candidate 1 ! 2025-04-17 Fixed formatting issues. Removed ambiguity around the section "Handling Requests with No Matching CitableUnits at the Requested Level(s)" (Issue 268) Clarified the behaviour of ?down=0 while no start/end/ref are provided (=400 Bad Request Error) (Issue 269) Allow CitableUnit to have @id for Linked Data usages (Issue 274). Clarify that headers of the Entry Endpoint SHOULD be JSON+LD (Issue 272). Clarify that MetadataObject MUST have their vocabularies defined, either by the main @context property if they are reusing base DTS vocabulary (including Dublin Core Terms) or by their own @context property. 2024-08-08 Made citeType required for CiteStructure objects. Removed maxCiteDepth everywhere, including in the example. 2024-08-06 Removed maxCiteDepth from Collection objects at the Collection endpoint now that we have a CitationTree object at the Resource level. Harmonized the properties for Resource objects between the Collection and Navigation endpoints. This involves adding required document and navigation properties, as well as allowing additional optional properties. Also removed the document and navigation properties from the Navigation object since these URI templates are now part of the Resource object. Added view properties for paginated responses to the Collection and Navigation endpoints. Added a Pagination object type to provide the pagination links. 2024-05-24 Removed totalItems from the Collection Endpoints (See https://github.com/distributed-text-services/specifications/issues/248, problem pointed out by @kbrueckmann) passage property (URI template) moved to document for consistency between Collection and Navigation endpoint (See https://github.com/distributed-text-services/specifications/issues/249, problem pointed out by @philippepons) Harmonized the examples to have the resource already populated, as per Collection URI Templates collection property (URI template) added to Collection and Resource object (See https://github.com/distributed-text-services/specifications/issues/250, problem pointed out by @philippepons) Fixed a typo in the Entry endpoint table, where it referenced Resources. What's Changed Adding unstable and fixing #250, #249 and #248 by @PonteIneptique in https://github.com/distributed-text-services/specifications/pull/251 Bump nokogiri from 1.14.3 to 1.15.6 by @dependabot[bot] in https://github.com/distributed-text-services/specifications/pull/247 Renaming "citeStructure" to "citationTrees" and other minor fixes by @monotasker in https://github.com/distributed-text-services/specifications/pull/256 Removed redundant maxCiteDepth from Collection object by @monotasker in https://github.com/distributed-text-services/specifications/pull/257 Add view property for handling pagination by @monotasker in https://github.com/distributed-text-services/specifications/pull/259 Definitely remove maxCiteDepth by @PonteIneptique in https://github.com/distributed-text-services/specifications/pull/263 Made citeType required for CiteStructure objects. by @PonteIneptique in https://github.com/distributed-text-services/specifications/pull/262 Fixing Resource properties in Navigation examples by @monotasker in https://github.com/distributed-text-services/specifications/pull/264 Fix examples using dictionaries as values for dublinCore by @PonteIneptique in https://github.com/distributed-text-services/specifications/pull/267 (Nearly) last changes before RC1. by @PonteIneptique in https://github.com/distributed-text-services/specifications/pull/275 JSON-LD context referencing terms of OWL ontology by @ingoboerner in https://github.com/distributed-text-services/specifications/pull/273 Update reference implementation and known servers by @PonteIneptique in https://github.com/distributed-text-services/specifications/pull/285 Fix a typo in FAQ by @davidbgk in https://github.com/distributed-text-services/specifications/pull/286 Apply nesting to extensions and dublinCore by @PonteIneptique in https://github.com/distributed-text-services/specifications/pull/283 Fix JSON formatting in 1-alpha1.json by @phcorp in https://github.com/distributed-text-services/specifications/pull/288 Fix Citation Tree unclear sistuation by @PonteIneptique in https://github.com/distributed-text-services/specifications/pull/289 Examples of uneven and parallel citation trees by @monotasker in https://github.com/distributed-text-services/specifications/pull/290 Added note on extensions and @context. by @hcayless in https://github.com/distributed-text-services/specifications/pull/291 Bump commonmarker from 0.17.13 to 0.23.10 by @dependabot[bot] in https://github.com/distributed-text-services/specifications/pull/292 Bump activesupport from 6.0.6.1 to 6.1.7.5 by @dependabot[bot] in https://github.com/distributed-text-services/specifications/pull/293 v1.0 update by @PonteIneptique in https://github.com/distributed-text-services/specifications/pull/294 New Contributors @ingoboerner made their first contribution in https://github.com/distributed-text-services/specifications/pull/273 @davidbgk made their first contribution in https://github.com/distributed-text-services/specifications/pull/286 @phcorp made their first contribution in https://github.com/distributed-text-services/specifications/pull/288 Full Changelog: https://github.com/distributed-text-services/specifications/compare/1-alpha1...v1.0