feat: Add legal info documentation (DEV-4502)

docs/01-introduction/example-project.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/01-introduction/file-formats.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/01-introduction/legal-info.md

@@ -0,0 +1,83 @@
+<!---
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * SPDX-License-Identifier: Apache-2.0
+-->
+
+# Storing Legal Information
+
+Each file representation in the project data may have legal metadata associated with it.
+This metadata is stored in the [FileValue](../02-dsp-ontologies/knora-base.md#filevalue) that represents the file.
+
+!!! warning "Legal Information Will Become Mandatory"
+
+    Currently, the legal information on the FileValue is optional. This will change in the future when License, Authorship, and Copyright Holder will become mandatory.
+
+## License
+
+The license under which the file is published.
+A license has the following properties:
+
+- `uri` - this is a URI that identifies the license.
+- `label-en` - this is a human-readable label for the license in English.
+- `id` - this is a unique identifier as an IRI for the license.
+
+Each project [restricts the licenses that can be used](/03-endpoints/api-admin/#get-adminprojectsshortcodeprojectshortcodelegal-infolicenses).
+
+Currently, the set of allowed licenses is fixed to [our predefined licenses](#predefined-licenses) and cannot be changed by the project.
+
+## Copyright Holder
+
+The copyright holder of the file.
+A copyright holder is a person or organization that holds the copyright to a file.
+
+Each project [references an allowed list of copyright holders](/03-endpoints/api-admin/#get-adminprojectsshortcodeprojectshortcodelegal-infocopyright-holders) that can be used.  
+System project administrators can [add new copyright holders](/03-endpoints/api-admin/#post-adminprojectsshortcodeprojectshortcodelegal-infocopyright-holders) to the list.
+
+## Authorship
+
+The authorship of the file.
+This can be a person or an organization who was involved in creating the asset, also known as moral rights to the asset.
+
+# Predefined Licenses
+
+We encourage the use of Creative Commons licenses for the publication of data.  
+Notable **CC BY 4.0** (Attribution 4.0 International) and **CC BY-SA 4.0** (Attribution-ShareAlike 4.0 International) licenses are well suited for [FAIR content](https://www.go-fair.org/fair-principles/).
+
+- **[Creative Commons](https://creativecommons.org/) Licenses**
+    - **CC BY 4.0** (Attribution 4.0 International)
+        - Id: `http://rdfh.ch/licenses/cc-by-4.0`
+        - URI: [https://creativecommons.org/licenses/by/4.0/](https://creativecommons.org/licenses/by/4.0/)
+        - Label-En: CC BY 4.0
+    - **CC BY-SA 4.0** (Attribution-ShareAlike 4.0 International)
+        - Id: `http://rdfh.ch/licenses/cc-by-sa-4.0`
+        - URI: [https://creativecommons.org/licenses/by-sa/4.0/](https://creativecommons.org/licenses/by-sa/4.0/)
+        - Label-En: CC BY-SA 4.0
+    - **CC BY-NC 4.0** (Attribution-NonCommercial 4.0 International)
+        - Id: `http://rdfh.ch/licenses/cc-by-nc-4.0`
+        - URI: [https://creativecommons.org/licenses/by-nc/4.0/](https://creativecommons.org/licenses/by-nc/4.0/)
+        - Label-En: CC BY-NC 4.0
+    - **CC BY-NC-SA 4.0** (Attribution-NonCommercial-ShareAlike 4.0 International)
+        - Id: `http://rdfh.ch/licenses/cc-by-nc-sa-4.0`
+        - URI: [https://creativecommons.org/licenses/by-nc-sa/4.0/](https://creativecommons.org/licenses/by-nc-sa/4.0/)
+        - Label-En: CC BY-NC-SA 4.0
+    - **CC BY-ND 4.0** (Attribution-NoDerivatives 4.0 International)
+        - Id: `http://rdfh.ch/licenses/cc-by-nd-4.0`
+        - URI: [https://creativecommons.org/licenses/by-nd/4.0/](https://creativecommons.org/licenses/by-nd/4.0/)
+        - Label-En: CC BY-ND 4.0
+    - **CC BY-NC-ND 4.0** (Attribution-NonCommercial-NoDerivatives 4.0 International)
+        - Id: `http://rdfh.ch/licenses/cc-by-nc-nd-4.0`
+        - URI: [https://creativecommons.org/licenses/by-nc-nd/4.0/](https://creativecommons.org/licenses/by-nc-nd/4.0/)
+        - Label-En: CC BY-NC-ND 4.0
+- **Special licenses**
+    - **AI-Generated Content - Not Protected by Copyright**
+        - Id: `http://rdfh.ch/licenses/ai-generated`
+        - URI: [http://rdfh.ch/licenses/ai-generated](http://rdfh.ch/licenses/ai-generated)
+        - Label-En: AI-Generated Content - Not Protected by Copyright
+    - **Unknown License - Ask Copyright Holder for Permission**
+        - Id: `http://rdfh.ch/licenses/unknown`
+        - URI: [http://rdfh.ch/licenses/unknown](http://rdfh.ch/licenses/unknown)
+        - Label-En: Unknown License - Ask Copyright Holder for Permission
+    - **Public Domain - Not Protected by Copyright**
+        - Id: `http://rdfh.ch/licenses/public-domain`
+        - URI: [http://rdfh.ch/licenses/public-domain](http://rdfh.ch/licenses/public-domain)
+        - Label-En: Public Domain - Not Protected by Copyright

docs/01-introduction/standoff-rdf.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/01-introduction/what-is-dsp.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/02-dsp-ontologies/introduction.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/02-dsp-ontologies/knora-base.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 
@@ -357,18 +357,18 @@ Each `ListNode` can have the following properties:
 
 DSP-API can store certain kinds of data outside the triplestore, in files (see [Representations](#representations)). Each
 digital object that is stored outside the triplestore has associated metadata, which is stored in the triplestore in
-a `kb:FileValue`. The base class `FileValue`, which is not intended to be used directly, has these properties:
-
-- `internalFilename` (1): The name of the file as stored by Knora.
-
-- `internalMimeType` (1): The MIME type of the file as stored by Knora.
-
-- `originalFilename` (0-1): The original name of the file when it was uploaded to the DSP-API server.
-
-- `originalMimeType` (0-1): The original MIME type of the file when it was uploaded to the Knora API server.
-
-- `isPreview` (0-1): A boolean indicating whether the file is a preview, i.e. a small image representing the contents of
-  the file. A preview is always a `StillImageAbstractFileValue`, regardless of the type of the enclosing `Representation`.
+a `kb:FileValue`. The base class `FileValue`, which is not intended to be used directly, has the following properties:
+
+- File metadata:
+    - `internalFilename` (1): The name of the file as stored by DSP.
+    - `internalMimeType` (1): The MIME type of the file as stored by DSP.
+    - `originalFilename` (0-1): The original name of the file when it was uploaded to DSP.
+    - `originalMimeType` (0-1): The original MIME type of the file when it was uploaded to DSP.
+   
+- Legal info metadata
+    - `hasAuthorship` (0-n): Indicates the authorship of the file, each author has their own string literal.
+    - `hasCopyrightHolder` (0-1): The copyright holder of the file, a string literal. The project restricts which values are allowed.
+    - `hasLicense` (0-1): The license under which the file is published, an IRI to the license. The project restricts which values are allowed.
 
 The subclasses of `FileValue`, which are intended to be used directly in data, include:
 

docs/02-dsp-ontologies/salsah-gui.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-admin/groups.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-admin/introduction.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-admin/lists.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-admin/overview.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-admin/permissions.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-admin/projects.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-admin/stores.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-admin/users.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-util/version.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-v2/authentication.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-v2/editing-resources.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-v2/editing-values.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-v2/getting-lists.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-v2/introduction.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-v2/knora-iris.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-v2/ontology-information.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-v2/permalinks.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-v2/query-language.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-v2/reading-and-searching-resources.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-v2/reading-user-permissions.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-v2/text/custom-standoff.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/api-v2/text/tei-xml.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/instrumentation/health.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/instrumentation/introduction.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/03-endpoints/instrumentation/metrics.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/04-publishing-deployment/configuration.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/04-publishing-deployment/publishing.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/05-internals/design/api-admin/administration.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/05-internals/design/api-v2/ark.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/05-internals/design/api-v2/content-wrappers.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/05-internals/design/api-v2/gravsearch.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/05-internals/design/api-v2/how-to-add-a-route.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->
 

docs/05-internals/design/api-v2/json-ld.md

@@ -1,5 +1,5 @@
 <!---
- * Copyright © 2021 - 2024 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
+ * Copyright © 2021 - 2025 Swiss National Data and Service Center for the Humanities and/or DaSCH Service Platform contributors.
  * SPDX-License-Identifier: Apache-2.0
 -->