Improve user guides

api-reference/python/tilebox.datasets/Client.mdx

@@ -47,8 +47,5 @@ client = Client(
     url="https://api.tilebox.com",
     token="YOUR_TILEBOX_API_KEY",
 )
-
-# use HTTP/1.1 if your network blocks or breaks gRPC over HTTP/2
-client = Client(transport="http1")
 ```
 </RequestExample>

api-reference/python/tilebox.workflows/Client.mdx

@@ -93,9 +93,6 @@ client = Client(
     name="sentinel-2-runner",
 )
 
-# use HTTP/1.1 if your network blocks or breaks gRPC over HTTP/2
-client = Client(transport="http1")
-
 # access sub clients
 job_client = client.jobs()
 cluster_client = client.clusters()

changelog.mdx

@@ -172,7 +172,7 @@ mode: center
 
     - [Spatio Temporal datasets documentation](https://docs.tilebox.com/datasets/types/spatiotemporal)
     - All open data now supports spatio-temporal queries
-    - [Create your own spatio-temporal datasets](/guides/datasets/create)
+    - [Create your own spatio-temporal datasets](/guides/datasets/build-spatiotemporal-catalog)
     - [Ingesting spatio-temporal data](/datasets/ingest)
 
 </Update>
@@ -198,5 +198,5 @@ mode: center
     3. Use client.ingest() to ingest a `xarray.Dataset` or `pandas.DataFrame`
     4. Query away!
 
-    For detailed instructions, check out the [Creating a dataset](/guides/datasets/create) how-to guide.
+    For detailed instructions, check out the [Build a spatio-temporal catalog](/guides/datasets/build-spatiotemporal-catalog) how-to guide.
 </Update>

datasets/concepts/datasets.mdx

@@ -11,11 +11,11 @@ icon: database
 ## Related Guides
 
 <Columns cols={2}>
-  <Card title="Creating a dataset" icon="database" href="/guides/datasets/create" horizontal>
-    Learn how to create a Timeseries dataset using the Tilebox Console.
+  <Card title="Build a spatio-temporal catalog" icon="database" href="/guides/datasets/build-spatiotemporal-catalog" horizontal>
+    Learn how to create a custom dataset catalog with the Python SDK.
   </Card>
-  <Card title="Ingesting data" icon="up-from-bracket" href="/guides/datasets/ingest" horizontal>
-    Learn how to ingest an existing CSV dataset into a Timeseries dataset collection.
+  <Card title="Ingest into a spatio-temporal catalog" icon="up-from-bracket" href="/guides/datasets/ingest-into-spatiotemporal-catalog" horizontal>
+    Learn how to ingest GeoParquet metadata into an existing spatio-temporal catalog.
   </Card>
 </Columns>
 
@@ -151,7 +151,7 @@ Once you have your dataset object, you can use it to [list the available collect
 
 ## Creating / Updating a dataset
 
-You can create a dataset using the [Tilebox Console](/guides/datasets/create) or by using one of the available [client SDKs](/sdks/introduction).
+You can create a dataset using one of the available [client SDKs](/sdks/introduction), or use the [Tilebox Console](/console) when you prefer a visual schema editor.
 
 <CodeGroup>
 ```python Python

datasets/ingest.mdx

@@ -19,7 +19,7 @@ The examples on this page assume that you have access to a [Timeseries dataset](
 
 <Accordion title="MyCustomDataset schema">
 <Tip>
-  Check out the [Creating a dataset](/guides/datasets/create) guide for an example of how to create such a dataset.
+  Check out the [Build a spatio-temporal catalog](/guides/datasets/build-spatiotemporal-catalog) guide for an example of how to create such a dataset.
 </Tip>
 
 **MyCustomDataset schema**

docs.json

@@ -147,18 +147,19 @@
           {
             "group": "Datasets",
             "pages": [
-              "guides/datasets/access-sentinel2-data",
               "guides/datasets/query-satellite-data",
-              "guides/datasets/create",
-              "guides/datasets/ingest",
-              "guides/datasets/ingest-format",
-              "guides/datasets/build-spatiotemporal-catalog"
+              "guides/datasets/access-sentinel2-data",
+              "guides/datasets/access-usgs-landsat-data",
+              "guides/datasets/build-spatiotemporal-catalog",
+              "guides/datasets/ingest-into-spatiotemporal-catalog",
+              "guides/datasets/ingest-format"
             ]
           },
           {
             "group": "Workflows",
             "pages": [
               "guides/workflows/run-your-first-workflow",
+              "guides/workflows/execute-tasks-in-parallel",
               "guides/workflows/build-and-deploy-workflow",
               "guides/workflows/deploy-to-your-compute",
               "guides/workflows/debug-failed-run",

guides/cookbook.mdx

@@ -12,40 +12,49 @@ export const cookbookSections = [
     description: "Find, model, ingest, and query geospatial metadata with Tilebox Datasets.",
     guides: [
       {
-        title: "Access Sentinel-2 data",
-        href: "/guides/datasets/access-sentinel2-data",
-        description: "Query Sentinel-2 metadata by area and time range.",
+        title: "Query open satellite data",
+        href: "/guides/datasets/query-satellite-data",
+        description: "Explore open data catalogs and query Sentinel-2 metadata by time and location.",
         icon: "satellite",
         level: "Beginner",
         time: "5 min",
-        tags: ["Open data", "Sentinel-2", "Spatial filters", "Python SDK"],
+        tags: ["Open data", "Sentinel-2", "Metadata queries", "Spatial filters"],
       },
       {
-        title: "Query satellite data by time and location",
-        href: "/guides/datasets/query-satellite-data",
-        description: "Narrow open data catalogs before downloading product files.",
+        title: "Access Copernicus data",
+        href: "/guides/datasets/access-sentinel2-data",
+        description: "Download Copernicus product files with the storage client, using Sentinel-2 as an example.",
         icon: "magnifying-glass-location",
         level: "Beginner",
-        time: "5 min",
-        tags: ["Open data", "Temporal filters", "Spatial filters", "Storage clients"],
+        time: "10 min",
+        tags: ["Copernicus", "Storage clients", "Sentinel-2", "Product files"],
       },
       {
-        title: "Creating a dataset",
-        href: "/guides/datasets/create",
-        description: "Create a custom dataset and define its schema in the Console.",
-        icon: "database",
+        title: "Access USGS Landsat data",
+        href: "/guides/datasets/access-usgs-landsat-data",
+        description: "Download USGS Landsat product files with the storage client, using Landsat 8 as an example.",
+        icon: "satellite-dish",
         level: "Beginner",
-        time: "5 min",
-        tags: ["Datasets", "Dataset schemas", "Console", "Timeseries datasets"],
+        time: "10 min",
+        tags: ["USGS", "Landsat 8", "Storage clients", "Product files"],
+      },
+      {
+        title: "Build a spatio-temporal catalog",
+        href: "/guides/datasets/build-spatiotemporal-catalog",
+        description: "Create, document, ingest, and query a custom geospatial catalog with the Python SDK.",
+        icon: "globe",
+        level: "Intermediate",
+        time: "20 min",
+        tags: ["Spatio-temporal datasets", "Dataset schemas", "Ingestion", "Python SDK"],
       },
       {
-        title: "Ingesting data",
-        href: "/guides/datasets/ingest",
-        description: "Ingest GeoParquet data into a Tilebox timeseries dataset.",
+        title: "Ingest into a spatio-temporal catalog",
+        href: "/guides/datasets/ingest-into-spatiotemporal-catalog",
+        description: "Prepare GeoParquet metadata and ingest it into an existing spatio-temporal catalog.",
         icon: "up-from-bracket",
         level: "Beginner",
         time: "15 min",
-        tags: ["Ingestion", "Timeseries datasets", "GeoParquet", "Python SDK"],
+        tags: ["Ingestion", "Spatio-temporal datasets", "GeoParquet", "Python SDK"],
       },
       {
         title: "Ingesting from common file formats",
@@ -56,15 +65,6 @@ export const cookbookSections = [
         time: "20 min",
         tags: ["Ingestion", "DataFrames", "xarray", "File formats"],
       },
-      {
-        title: "Build a spatio-temporal catalog",
-        href: "/guides/datasets/build-spatiotemporal-catalog",
-        description: "Create a geospatial catalog that can be queried by time and geometry.",
-        icon: "globe",
-        level: "Intermediate",
-        time: "15 min",
-        tags: ["Spatio-temporal datasets", "Geometry", "Ingestion", "Catalogs"],
-      },
     ],
   },
   {
@@ -80,6 +80,15 @@ export const cookbookSections = [
         time: "10 min",
         tags: ["Tasks", "Jobs", "Direct runners", "Python SDK"],
       },
+      {
+        title: "Execute tasks in parallel",
+        href: "/guides/workflows/execute-tasks-in-parallel",
+        description: "Submit many subtasks and process them with several direct runners at the same time.",
+        icon: "arrows-split-up-and-left",
+        level: "Beginner",
+        time: "15 min",
+        tags: ["Tasks", "Subtasks", "Direct runners", "Parallelism"],
+      },
       {
         title: "Build and deploy a workflow project",
         href: "/guides/workflows/build-and-deploy-workflow",