From e095204bd5399e73dabd6c5f612bfc2248924d84 Mon Sep 17 00:00:00 2001
From: philippepons <philippe.pons@chartes.psl.eu>
Date: Thu, 15 Feb 2024 11:16:42 +0100
Subject: [PATCH] update documentation: 'collection' instead of 'collections'

---
 docs/cookbook.md            | 49 +------------------------------------
 docs/dots-project-folder.md |  2 +-
 docs/index.md               |  2 +-
 docs/openapi.json           |  4 +--
 4 files changed, 5 insertions(+), 52 deletions(-)

diff --git a/docs/cookbook.md b/docs/cookbook.md
index d8efc0c..39beec8 100644
--- a/docs/cookbook.md
+++ b/docs/cookbook.md
@@ -65,20 +65,6 @@ Il convient de déclarer chacune de ces unités documentaires.
 |position          |document        |TEI file |`data/ENCPOS_AAAA/ENCPOS_AAAA_NN.xml`|
 |section           |fragment        |TEI node |`/TEI/text/boby/div`|
 
-<!-- **Collections**. Il suffit d’organiser le dossier `data/` en collections et sous-collections par défaut. Les métadonnées peuvent être déportées dans un TSV (ici `default_collections_titles.tsv`).
-
-**Documents**. Les documents correspondent aux fichiers XML/TEI.
-
-**Fragments**. La hiérarchie des fragments est déclarée, pour chaque document, grâce à l’élément <a href="https://www.tei-c.org/release/doc/tei-p5-doc/fr/html/ref-citeStructure.html" target="_blank">`citeStructure`</a> du `teiHeader` :
-
-???+ example "Example de `tei:citeStructure`"
-
-    ```xml
-      <citeStructure unit="chapter" match="/TEI/text/body/div" use="position()">
-        <citeData use="head" property="dc:title"/>
-      </citeStructure>
-    ```
--->
 #### Corpus de test
 
 Le corpus de test est disponible : <a href="https://github.com/chartes/dots_documentation/tree/dev/data_test/periodiques/encpos_by_abstract" target="_blank">https://github.com/chartes/dots_documentation/tree/dev/data_test/periodiques/encpos_by_abstract</a>.
@@ -126,7 +112,7 @@ Il contient les métadonnées descriptives des ressources : `default_collections
 
 Le fichier `dots_metadata_mapping.xml` est important. Il permet de :
 
-- lister et qualifier les métadonnées partagées via le endpoint DTS Collections ;
+- lister et qualifier les métadonnées partagées via le endpoint DTS Collection ;
 - déclarer leur localisation.
 
 Ces métadonnées peuvent être inscrites "en dure" dans le document `dots_metadata_mapping.xml`. Autrement dit, la valeur est inscrite directement dans le document XML.
@@ -233,39 +219,6 @@ Il convient de déclarer chacune de ces unités documentaires.
 |position          |fragment        |TEI node |`/TEI/text/boby/div[@type='position]'`|
 |section           |fragment        |TEI node |`/TEI/text/boby/div[@type='position]/div`|
 
-
-<!--**Collections**. Il suffit d’organiser le dossier `data/` en collections et sous-collections par défaut.
-
-{{ macro_collapse_card_api_doc(
-  verb_http="get", 
-  url="http://localhost:8080/api/dts/collection?id=ENCPOS_c2")
-}}
-
-**Documents**. Les documents correspondent aux fichiers XML/TEI.
-
-**Fragments**. La hiérarchie des fragments est déclarée, pour chaque document, grâce à l’élément `citeStructure` du `teiHeader` :
-
-???+ example "`citeStructure`"
-
-    ```xml
-    <citeStructure unit="position" match="/TEI/text/body/div[@type='position']" use="@xml:id">
-      <citeData use="head" property="dc:title"/>
-      <citeStructure unit="chapter" match="div" use="position()">
-        <citeData use="head" property="dc:title"/>
-      </citeStructure>
-    </citeStructure>
-    ```
-
-{{ macro_collapse_card_api_doc(
-  verb_http="get", 
-  url="http://localhost:8080/api/dts/navigation?id=ENCPOS_1972_c2")
-}}
-
-{{ macro_collapse_card_api_doc(
-  verb_http="get", 
-  url="http://localhost:8080/api/dts/navigation?id=ENCPOS_1972_c2&ref=ENCPOS_1972_18")
-}}
--->
 #### Corpus de test
 
 Le corpus de test est disponible : <a href="https://github.com/chartes/dots_documentation/tree/dev/data_test/periodiques/encpos_by_volume" target="_blank">https://github.com/chartes/dots_documentation/tree/dev/data_test/periodiques/encpos_by_volume</a>.
diff --git a/docs/dots-project-folder.md b/docs/dots-project-folder.md
index 6ed6b1d..ba803b9 100644
--- a/docs/dots-project-folder.md
+++ b/docs/dots-project-folder.md
@@ -59,7 +59,7 @@ Vous pouvez structurer vos documents en collections et sous-collections hiérarc
 			tartuffe.xml
 	```
 
-??? example "Le projet contient des collections"
+??? example "Le projet contient des sous-collections"
 
 	```
 	theater_project/
diff --git a/docs/index.md b/docs/index.md
index ee1bd54..d234cd4 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -18,7 +18,7 @@ Publishers of digital text collections can use the DTS API to help them make the
 
 Using DoTS, you can
 
-- with the DTS Collections endpoint:
+- with the DTS Collection endpoint:
 	- Retrieve lists of collection members.
 	- Retrieve metadata about individual collection items.
 - with the DTS Navigation endpoint:
diff --git a/docs/openapi.json b/docs/openapi.json
index 0eb2313..c70f74b 100644
--- a/docs/openapi.json
+++ b/docs/openapi.json
@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "DoTS - OpenAPI 3.0",
-    "description": "**Documentation and specification of the [DTS API](https://distributed-text-services.github.io/specifications/) implementation by [DoTS](https://github.com/chartes/dots).** \n\n  DoTS is a suite of XQuery tools in [BaseX](https://basex.org/) designed to provide a resolver for the DTS API. \n \n This API offers an access to the endpoints :\n * Base API Endpoint \n * collections (navigating collections) \n * navigation (list of passages accessible for navigation from a given reference within a resource) \n * document (acces to the content of document) ",
+    "description": "**Documentation and specification of the [DTS API](https://distributed-text-services.github.io/specifications/) implementation by [DoTS](https://github.com/chartes/dots).** \n\n  DoTS is a suite of XQuery tools in [BaseX](https://basex.org/) designed to provide a resolver for the DTS API. \n \n This API offers an access to the endpoints :\n * Base API Endpoint \n * collection (navigating collections) \n * navigation (list of passages accessible for navigation from a given reference within a resource) \n * document (acces to the content of document) ",
     "license": {
       "name": "MIT",
       "url": "https://opensource.org/licenses/MIT"
@@ -51,7 +51,7 @@
         }
       }
     },
-    "/dts/collections": {
+    "/dts/collection": {
       "get": {
         "tags": [
           "default"