Update datagouv documentation

Author: Ndpnt

content/api/cli.md

@@ -58,7 +58,7 @@ 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
+- **data.gouv.fr**: Requires `OTA_ENGINE_DATAGOUV_API_KEY` environment variable. To set up data.gouv.fr publishing, see the [guide to publish datasets to data.gouv.fr]({{< relref "collections/how-to/publish-to-datagouv" >}}).
 
 These environment variables can be defined in a [`.env` file]({{< relref "collections/reference/environment-variables" >}}).
 
@@ -70,16 +70,6 @@ To export, publish the dataset and remove the local copy that was created after
 
 {{< 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:
-
-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
 
 {{< refItem name="ota serve" description="Start the collection Web API server. The Web API will be available under `<http://localhost>:<port>/<basePath>/<apiVersion>/<resource>`. The server port and base path are defined in the configuration." example="npx ota serve" />}}

content/collections/reference/configuration.md

@@ -199,25 +199,39 @@ The dataset section configures how datasets are published. Datasets can be publi
 {{< refItem
     name="dataset.publishingSchedule"
     type="string"
-    description="Cron expression for dataset publishing. By default, it runs every Monday at 8:30 AM."
+    description="Cron expression for dataset publishing. By default, it runs every Monday at 8:30 AM. If publishing to data.gouv.fr, remember to update `dataset.datagouv.frequency` to match the actual publishing frequency."
     default="30 8 * * MON"
 />}}
 
 #### data.gouv.fr publishing
 
-The data.gouv.fr section configures publishing to the French government's open data platform.
+The data.gouv.fr section configures publishing to the French government's open data platform. Either `datasetId` or `organizationIdOrSlug` must be configured.
 
 {{< 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."
+    description="ID of an existing dataset on data.gouv.fr. Use this to publish to an existing dataset. Either this or `organizationIdOrSlug` is required."
     example="6914a64b17a0a91bb0a61222"
 />}}
 
+{{< refItem
+    name="dataset.datagouv.organizationIdOrSlug"
+    type="string"
+    description="ID or slug of the organization on data.gouv.fr. Use this to automatically create and publish a dataset. The dataset will be created with the title from `dataset.title` if it doesn't exist. Either this or `datasetId` is required."
+    example="open-terms-archive"
+/>}}
+
+{{< refItem
+    name="dataset.datagouv.frequency"
+    type="string"
+    description="Update frequency of the dataset. Used when creating or updating a dataset on data.gouv.fr. See [data.gouv.fr API](https://www.data.gouv.fr/api/1/datasets/frequencies/) for all allowed values."
+    example="weekly"
+/>}}
+
 {{< refItem
     name="dataset.datagouv.useDemo"
     type="boolean"
-    description="Set to true to use the demo.data.gouv.fr environment for testing."
+    description="Set to `true` to use the demo.data.gouv.fr environment for testing."
     default="false"
 />}}
 

content/collections/reference/environment-variables.md

@@ -19,10 +19,10 @@ This reference documentation details all available environment variables that ca
 
 {{< 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." />}}
+{{< refItem name="OTA_ENGINE_DATAGOUV_API_KEY" type="string" description="API key for data.gouv.fr dataset publishing." />}}
 
 ---
 
-### Federation API 
+### Federation API
 
 {{< refItem name="OTA_FEDERATION_API_SMTP_PASSWORD" type="string" description="SMTP password for email error notifications." />}}