From f9fe95cdf0d05a0ab5a8346f319dc57b1c2e9c22 Mon Sep 17 00:00:00 2001 From: Fernando Mercado Date: Mon, 3 Aug 2026 11:29:46 -0500 Subject: [PATCH 1/2] Expand category meta descriptions to recommended 120-160 char length Flagged by SEO audit as too short to avoid truncation in search results. --- docs/getting-started/_category_.yaml | 2 +- docs/how-tos/airflow/dags/_category_.yaml | 2 +- docs/how-tos/datahub/_category_.yaml | 2 +- docs/how-tos/dbt/_category_.yaml | 2 +- docs/how-tos/superset/_category_.yaml | 2 +- docs/how-tos/vs-code/external-ai-tools/_category_.yaml | 2 +- docs/reference/airflow/_category_.yaml | 2 +- docs/reference/datacoves/_category_.yaml | 2 +- docs/tutorials/_category_.yaml | 2 +- 9 files changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/getting-started/_category_.yaml b/docs/getting-started/_category_.yaml index 8667c121..cfe54f15 100644 --- 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/how-tos/airflow/dags/_category_.yaml b/docs/how-tos/airflow/dags/_category_.yaml index 2e89053e..a9e62091 100644 --- 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 index 0f3a00e6..069d5fdb 100644 --- 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. \ No newline at end of file + description: How-to guides for integrating DataHub with Datacoves, including ingesting metadata from dbt and Snowflake, and using the DataHub CLI for lineage tracking. \ No newline at end of file diff --git a/docs/how-tos/dbt/_category_.yaml b/docs/how-tos/dbt/_category_.yaml index 416e5d7e..9a57cb76 100644 --- 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. \ No newline at end of file + description: How-to guides for resolving common dbt issues in Datacoves, including compilation errors, database errors, dependency errors, and runtime errors. \ No newline at end of file diff --git a/docs/how-tos/superset/_category_.yaml b/docs/how-tos/superset/_category_.yaml index 9315c7ba..87fcf3e9 100644 --- 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. \ No newline at end of file + description: How-to guides for using Superset in Datacoves, including connecting to your data warehouse and creating datasets for building dashboards and visualizations. \ No newline at end of file diff --git a/docs/how-tos/vs-code/external-ai-tools/_category_.yaml b/docs/how-tos/vs-code/external-ai-tools/_category_.yaml index a313acb9..dc815c53 100644 --- 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/airflow/_category_.yaml b/docs/reference/airflow/_category_.yaml index 44c1446c..5676a861 100644 --- 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. \ No newline at end of file + description: Reference documentation for Airflow in Datacoves, covering configuration defaults, variables, DAG generators, decorators, CLI commands, operators, and billing. \ No newline at end of file diff --git a/docs/reference/datacoves/_category_.yaml b/docs/reference/datacoves/_category_.yaml index 140f598f..33673cf0 100644 --- 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. \ No newline at end of file + description: Reference documentation for core Datacoves concepts, including semantic versioning, VPC deployment requirements, and the rollback strategy for upgrades. \ No newline at end of file diff --git a/docs/tutorials/_category_.yaml b/docs/tutorials/_category_.yaml index 24ef5af8..8f82fd24 100644 --- 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. \ No newline at end of file + description: Explore hands-on tutorials and curated external resources covering dbt, Airflow, and data engineering fundamentals to get the most from Datacoves. \ No newline at end of file From 726ad2ba4ae56d7a8e5b7a53a09d5f5f45e24f36 Mon Sep 17 00:00:00 2001 From: Fernando Mercado Date: Mon, 3 Aug 2026 11:36:43 -0500 Subject: [PATCH 2/2] Trim category meta descriptions to recommended 120-160 char length Flagged by SEO audit as too long, risking truncation in search results. --- docs/best-practices/_category_.yaml | 2 +- docs/best-practices/snowflake/_category_.yaml | 2 +- docs/getting-started/admin/_category_.yaml | 2 +- docs/getting-started/developer/_category_.yaml | 2 +- docs/how-tos/vs-code/_category_.yaml | 2 +- docs/reference/_category_.yaml | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/best-practices/_category_.yaml b/docs/best-practices/_category_.yaml index f10ffa12..79950b4a 100644 --- 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 index 390c9cc5..9664133d 100644 --- 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/admin/_category_.yaml b/docs/getting-started/admin/_category_.yaml index d4769986..4b2db83c 100644 --- 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 index 96e3e598..201da03f 100644 --- 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/vs-code/_category_.yaml b/docs/how-tos/vs-code/_category_.yaml index f971e39e..2728d65a 100644 --- 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. \ No newline at end of file + description: How-to guides for the Datacoves Hosted VS Code IDE, covering shell customization, environment variables, git reset, restoring files, and external AI tools. \ No newline at end of file diff --git a/docs/reference/_category_.yaml b/docs/reference/_category_.yaml index 610624a4..7970ca2e 100644 --- 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 \ No newline at end of file + description: Reference guides give you detailed information on Datacoves platform topics, covering Airflow, security, versioning, service connections, and more. \ No newline at end of file