docs: Update structure of Polars Cloud documentation

docs/source/polars-cloud/organizations.md → docs/source/polars-cloud/organization/organizations.md

@@ -1,4 +1,4 @@
-# Organizations
+# Set up organization
 
 Organizations in Polars Cloud are the top-level entity and typically represent a company. They can
 have members, contain multiple workspaces and are what you couple your billing to after the current

docs/source/polars-cloud/run/compute-context.md

@@ -1,4 +1,4 @@
-# Defining a compute context
+# Define compute context
 
 The compute context defines the hardware configuration used to execute your queries. This can be
 either a single node or, for distributed execution, multiple nodes. This section explains how to set

docs/source/polars-cloud/run/distributed-engine.md

@@ -1,4 +1,4 @@
-# Distributed query execution
+# Execute distributed query
 
 With the introduction of Polars Cloud, we also introduced the distributed engine. This engine
 enables users to horizontally scale workloads across multiple machines.

docs/source/polars-cloud/run/workflow.md → docs/source/polars-cloud/run/example-workflow.md

@@ -1,4 +1,4 @@
-# Workflow tips
+# Example workflow
 
 Data processing and analytics often begins small but can quickly grow beyond the capabilities of
 your local machine. A typical workflow starts with exploring a sample dataset locally, developing

docs/source/polars-cloud/workspace/settings.md

@@ -1,4 +1,4 @@
-# Configuring workspace settings
+# Configure settings
 
 The Workspace Settings page provides a centralized interface for managing your workspace
 configuration.

docs/source/polars-cloud/workspace/team.md

@@ -1,4 +1,4 @@
-# Manage workspace members
+# Manage members
 
 The Team page serves as a central hub for managing who has access to the workspace. Administrators
 are able to invite collaborators, monitor membership status, and manage user permissions.
@@ -27,6 +27,6 @@ The invitee can use this link to join the workspace without requiring an email i
 <!-- dprint-ignore-start -->
 
 !!! info "Inviting existing users"
-    Users that are already part of another workspace will get a prompt to join the workspace they are invited for.
+Users that are already part of another workspace will get a prompt to join the workspace they are invited for.
 
 <!-- dprint-ignore-end -->

mkdocs.yml

@@ -113,15 +113,17 @@ nav:
           - polars-cloud/index.md
           - polars-cloud/quickstart.md
           - polars-cloud/connect-cloud.md
-          - User guide:
-                - polars-cloud/organizations.md
+
+          - Organizations:
+                - polars-cloud/organization/organizations.md
+          - Workspaces:
+                - polars-cloud/workspace/settings.md
+                - polars-cloud/workspace/team.md
+          - Workflows:
                 - polars-cloud/run/compute-context.md
-                - polars-cloud/run/workflow.md
                 - polars-cloud/run/interactive-batch.md
                 - polars-cloud/run/distributed-engine.md
-          - Manage workspace:
-                - polars-cloud/workspace/settings.md
-                - polars-cloud/workspace/team.md
+                - polars-cloud/run/example-workflow.md
           - Authentication:
                 - polars-cloud/explain/authentication.md
                 - polars-cloud/explain/service-accounts.md