Add datagouv dataset publishing documentation

Author: Ndpnt

content/api/cli.md

@@ -48,19 +48,37 @@ In these commands:
 
 ## Publishing dataset
 
-{{< refItem name="ota dataset [--file <filename>]" description="Export the versions dataset into a ZIP file and publish it to GitHub releases. The dataset title and the URL of the versions repository are defined in the configuration." example="npx ota dataset --file dataset.zip" />}}
+{{< refItem name="ota dataset [--file <filename>]" description="Export the versions dataset into a ZIP file. The dataset title is defined in the configuration." example="npx ota dataset --file dataset.zip" />}}
 
-To export the dataset into a ZIP file and publish it on GitHub releases:
+To export the dataset into a ZIP file and publish it to configured platforms (GitHub releases, GitLab releases, and/or data.gouv.fr):
 
-{{< refItem name="ota dataset --publish [--file <filename>]" description="Export and publish dataset to GitHub releases" example="GITHUB_TOKEN=ghp_XXXXXXXXX npx ota dataset --publish" />}}
+{{< refItem name="ota dataset --publish [--file <filename>]" description="Export and publish dataset to all configured platforms" example="npx ota dataset --publish" />}}
 
-The `GITHUB_TOKEN` can also be defined in a [`.env` file]({{< relref "collections/reference/environment-variables" >}}).
+The dataset can be published to multiple platforms simultaneously:
+
+- **GitHub releases**: Requires `OTA_ENGINE_GITHUB_TOKEN` environment variable
+- **GitLab releases**: Requires `OTA_ENGINE_GITLAB_TOKEN` environment variable (used only if GitHub token is not configured)
+- **data.gouv.fr**: Requires `OTA_ENGINE_DATAGOUV_API_KEY` environment variable and `dataset.datagouv.datasetId` in configuration
+
+These environment variables can be defined in a [`.env` file]({{< relref "collections/reference/environment-variables" >}}).
+
+> **Note**: If both GitHub and GitLab tokens are configured, GitHub takes precedence. data.gouv.fr can be used alongside either GitHub or GitLab.
 
 To export, publish the dataset and remove the local copy that was created after it has been uploaded:
 
-{{< refItem name="ota dataset --publish --remove-local-copy [--file <filename>]" description="Export, publish dataset and remove local copy after upload" example="GITHUB_TOKEN=ghp_XXXXXXXXX npx ota dataset --publish --remove-local-copy" />}}
+{{< refItem name="ota dataset --publish --remove-local-copy [--file <filename>]" description="Export, publish dataset and remove local copy after upload" example="npx ota dataset --publish --remove-local-copy" />}}
+
+{{< refItem name="ota dataset --schedule [--file <filename>]" description="Schedule export, publishing and local copy removal" example="npx ota dataset --schedule --publish --remove-local-copy" />}}
+
+### Setting up data.gouv.fr publishing
+
+Before publishing to data.gouv.fr for the first time, you need to:
 
-{{< refItem name="ota dataset --schedule [--file <filename>]" description="Schedule export, publishing and local copy removal" example="GITHUB_TOKEN=ghp_XXXXXXXXX npx ota dataset --schedule --publish --remove-local-copy" />}}
+1. Create a dataset on [data.gouv.fr](https://www.data.gouv.fr/) or [demo.data.gouv.fr](https://demo.data.gouv.fr/) (for testing)
+2. Copy the dataset ID from the URL (e.g., `6914a64b17a0a91bb0a61222`)
+3. Add it to your configuration at `dataset.datagouv.datasetId`
+4. Set `dataset.datagouv.useDemo` to `true` if using the demo environment
+5. Set the `OTA_ENGINE_DATAGOUV_API_KEY` environment variable with your API key
 
 ## Exposing the collection API
 

content/collections/reference/configuration.md

@@ -180,7 +180,7 @@ The reporter section manages how issues are reported when terms content is inacc
 
 ### Dataset
 
-The dataset section configures how datasets are published.
+The dataset section configures how datasets are published. Datasets can be published to GitHub releases, GitLab releases, and/or data.gouv.fr. If both GitHub and GitLab tokens are configured, GitHub takes precedence.
 
 {{< refItem
     name="dataset.title"
@@ -203,6 +203,24 @@ The dataset section configures how datasets are published.
     default="30 8 * * MON"
 />}}
 
+#### data.gouv.fr publishing
+
+The data.gouv.fr section configures publishing to the French government's open data platform.
+
+{{< refItem
+    name="dataset.datagouv.datasetId"
+    type="string"
+    description="ID of the dataset on data.gouv.fr. Required for publishing to data.gouv.fr. Must be created manually on the data.gouv.fr website."
+    example="6914a64b17a0a91bb0a61222"
+/>}}
+
+{{< refItem
+    name="dataset.datagouv.useDemo"
+    type="boolean"
+    description="Set to true to use the demo.data.gouv.fr environment for testing."
+    default="false"
+/>}}
+
 ### Collection API
 
 The collection API section sets the parameters for the API server.

content/collections/reference/environment-variables.md

@@ -13,12 +13,14 @@ This reference documentation details all available environment variables that ca
 
 {{< refItem name="OTA_ENGINE_SENDINBLUE_API_KEY" type="string" description="API key for SendInBlue." />}}
 
-{{< refItem name="OTA_ENGINE_GITHUB_TOKEN" type="string" description="GitHub token for API access." />}}
+{{< refItem name="OTA_ENGINE_GITHUB_TOKEN" type="string" description="GitHub token for API access and dataset publishing. If both GitHub and GitLab tokens are configured, GitHub takes precedence for dataset publishing." />}}
 
-{{< refItem name="OTA_ENGINE_GITLAB_TOKEN" type="string" description="GitLab token for API access." />}}
+{{< refItem name="OTA_ENGINE_GITLAB_TOKEN" type="string" description="GitLab token for API access and dataset publishing. Used only if GitHub token is not configured." />}}
 
 {{< refItem name="OTA_ENGINE_GITLAB_RELEASES_TOKEN" type="string" description="GitLab token for dataset releases." />}}
 
+{{< refItem name="OTA_ENGINE_DATAGOUV_API_KEY" type="string" description="API key for data.gouv.fr dataset publishing. Requires dataset.datagouv.datasetId to be configured." />}}
+
 ---
 
 ### Federation API