datacoves · noel · Aug 3, 2026 · Aug 3, 2026 · Aug 3, 2026
diff --git a/docs/best-practices/_category_.yaml b/docs/best-practices/_category_.yaml
@@ -3,6 +3,6 @@ position: 4
 link:
   type: generated-index
   title: Best Practices
-  description:  Here we present some guidance to help you mature your analytics practice. This guidance comes from experience working at large enterprises. While not written to account for very complex environments, these principles can be used to form a solid foundation that will scale as your team grows.
+  description: Guidance to help mature your analytics practice, covering dbt, Snowflake, git, and VS Code, drawn from experience working with large enterprise data teams.
 
 
diff --git a/docs/best-practices/snowflake/_category_.yaml b/docs/best-practices/snowflake/_category_.yaml
@@ -3,6 +3,6 @@ position: 1
 link:
   type: generated-index
   title: Snowflake
-  description: Here we present some guidance for Snowflake including setting up a scalable security model, managing time-travel while meeting GDPR requirements, and comparing tables across environments during pipeline migrations.
+  description: Best practices for Snowflake, including setting up a scalable security model, managing time-travel while meeting GDPR requirements, and comparing tables.
 
 
diff --git a/docs/getting-started/_category_.yaml b/docs/getting-started/_category_.yaml
@@ -3,5 +3,5 @@ position: 1
 link:
   type: generated-index
   title: Getting Started
-  description:  Learn the essentials to quickly get started as an Administrator or Developer.
+  description: Learn the essentials to quickly get started with Datacoves as an Administrator or Developer, from creating your account to configuring your first project.
 
diff --git a/docs/getting-started/admin/_category_.yaml b/docs/getting-started/admin/_category_.yaml
@@ -3,6 +3,6 @@ position: 3
 link:
   type: generated-index
   title: Administrator
-  description:  Welcome Administrator! You have the important role of configuring the Datacoves platform to fit your needs. No worries, you are not alone. We are here to help you every step of the way so you and your team can start delivering valuable insights in no time! Please follow the documentation below to get your dbt project up and running.  
+  description: Getting started guides for Datacoves Administrators, covering repository setup with dbt-coves, configuring Airflow, creating DAGs, and managing users.  
 
 
diff --git a/docs/getting-started/developer/_category_.yaml b/docs/getting-started/developer/_category_.yaml
@@ -3,5 +3,5 @@ position: 5
 link:
   type: generated-index
   title: Developer
-  description:  Welcome Developer! Please use these getting started guides to accelerate your onboarding. The guides cover everything from configuring your user settings to fundamental tips and shortcuts. 
+  description: Getting started guides for Datacoves Developers, covering the Snowflake extension, the Transform Tab, working with dbt, and using git in your workflow.
 
diff --git a/docs/how-tos/airflow/dags/_category_.yaml b/docs/how-tos/airflow/dags/_category_.yaml
@@ -3,4 +3,4 @@ position: 11
 link:
   type: generated-index
   title: DAGs
-  description: Here you will find information on DAGs in Datacoves.
+  description: How-to guides for building Airflow DAGs in Datacoves, covering scheduling, variables and connections, generating DAGs from YAML, and running dbt tasks.
diff --git a/docs/how-tos/datahub/_category_.yaml b/docs/how-tos/datahub/_category_.yaml
@@ -4,4 +4,4 @@ position: 3
 link:
   type: generated-index
   title: Datahub
-  description: These how to guides are dedicated to DataHub in Datacoves.
+  description: How-to guides for integrating DataHub with Datacoves, including ingesting metadata from dbt and Snowflake, and using the DataHub CLI for lineage tracking.
diff --git a/docs/how-tos/dbt/_category_.yaml b/docs/how-tos/dbt/_category_.yaml
@@ -4,4 +4,4 @@ position: 5
 link:
   type: generated-index
   title: dbt
-  description: These how to guides cover how to resolve common dbt issues.
+  description: How-to guides for resolving common dbt issues in Datacoves, including compilation errors, database errors, dependency errors, and runtime errors.
diff --git a/docs/how-tos/superset/_category_.yaml b/docs/how-tos/superset/_category_.yaml
@@ -4,4 +4,4 @@ position: 10
 link:
   type: generated-index
   title: Superset
-  description: These how to guides are dedicated to Superset in Datacoves.
+  description: How-to guides for using Superset in Datacoves, including connecting to your data warehouse and creating datasets for building dashboards and visualizations.
diff --git a/docs/how-tos/vs-code/_category_.yaml b/docs/how-tos/vs-code/_category_.yaml
@@ -3,4 +3,4 @@ position: 50
 link:
   type: generated-index
   title: VS Code in Datacoves
-  description: These how to guides are dedicated to our Hosted VS Code. This powerful IDE gives you all the power you need along with the customization options. These steps are essential to our Transform Tab.
+  description: How-to guides for the Datacoves Hosted VS Code IDE, covering shell customization, environment variables, git reset, restoring files, and external AI tools.
diff --git a/docs/how-tos/vs-code/external-ai-tools/_category_.yaml b/docs/how-tos/vs-code/external-ai-tools/_category_.yaml
@@ -3,4 +3,4 @@ position: 45
 link:
   type: generated-index
   title: External AI Tools
-  description: Configure and use external AI coding assistants in Datacoves.
+  description: Configure and use external AI coding assistants such as Claude Code and OpenAI Codex inside the Datacoves VS Code environment to speed up development.
diff --git a/docs/reference/_category_.yaml b/docs/reference/_category_.yaml
@@ -2,4 +2,4 @@ label: Reference
 position: 4
 link:
   type: generated-index
-  description: Reference Guides give you detailed information on a given topic. If you have recommendations for reference guides, please send us an email at support@datacoves.co
+  description: Reference guides give you detailed information on Datacoves platform topics, covering Airflow, security, versioning, service connections, and more.
diff --git a/docs/reference/airflow/_category_.yaml b/docs/reference/airflow/_category_.yaml
@@ -3,4 +3,4 @@ position: 3
 link:
   type: generated-index
   title: Airflow Reference
-  description: This is Datacoves Airflow References.
+  description: Reference documentation for Airflow in Datacoves, covering configuration defaults, variables, DAG generators, decorators, CLI commands, operators, and billing.
diff --git a/docs/reference/datacoves/_category_.yaml b/docs/reference/datacoves/_category_.yaml
@@ -3,4 +3,4 @@ position: 3
 link:
   type: generated-index
   title: Datacoves Reference
-  description: This is Datacoves References. 
+  description: Reference documentation for core Datacoves concepts, including semantic versioning, VPC deployment requirements, and the rollback strategy for upgrades.
diff --git a/docs/tutorials/_category_.yaml b/docs/tutorials/_category_.yaml
@@ -2,4 +2,4 @@ label: Tutorials
 position: 5
 link:
   type: generated-index
-  description: Explore tutorials and external resources for learning.
+  description: Explore hands-on tutorials and curated external resources covering dbt, Airflow, and data engineering fundamentals to get the most from Datacoves.