datacoves · fmercadop · Jun 22, 2026
diff --git a/docs/best-practices/datacoves/README.md b/docs/best-practices/datacoves/README.md
@@ -1,5 +1,7 @@
 ---
-title: Datacoves
+title: Datacoves Platform Best Practices
+sidebar_label: Datacoves
+description: "Recommended practices for organizing and using Datacoves, including project folder structure and configuration guidance for enterprise data engineering teams."
 sidebar_position: 1
 ---
 # Best practices on datacoves

diff --git a/docs/best-practices/datacoves/folder-structure.md b/docs/best-practices/datacoves/folder-structure.md
@@ -1,5 +1,7 @@
 ---
-title: Folder structure
+title: Datacoves Project Folder Structure Guide
+sidebar_label: Folder Structure
+description: "Learn the recommended repository layout for Datacoves: required folders like automate/dbt and orchestrate/dags, plus optional dbt-coves configuration paths."
 sidebar_position: 1
 ---
 

diff --git a/docs/best-practices/dbt/README.md b/docs/best-practices/dbt/README.md
@@ -1,5 +1,7 @@
 ---
-title: dbt 
+title: "dbt Best Practices: Tools, Packages & Guidelines"
+sidebar_label: dbt
+description: "An overview of dbt best practices in Datacoves: macro naming standards, open-source packages, coding tools like dbt-coves and SQLFluff, and governance checks."
 sidebar_position: 2
 ---
 # Overview

diff --git a/docs/best-practices/dbt/dbt-guidelines.md b/docs/best-practices/dbt/dbt-guidelines.md
@@ -1,5 +1,7 @@
 ---
-title: dbt guidelines
+title: dbt Project Guidelines for Enterprise Data Teams
+sidebar_label: Guidelines
+description: "Coding standards and decision-making guidelines for dbt projects in Datacoves: model structure, source definitions, testing, and documentation best practices."
 sidebar_position: 1
 ---
 

diff --git a/docs/best-practices/dbt/inlets-bays-coves.md b/docs/best-practices/dbt/inlets-bays-coves.md
@@ -1,5 +1,7 @@
 ---
-title: What are Inlets, Bays, and Coves
+title: "Inlets, Bays & Coves: Datacoves dbt Layer Model"
+sidebar_label: "Inlets, Bays & Coves"
+description: "Understand Datacoves' three-tier dbt architecture: Inlets for raw source data, Bays for intermediate transformations, and Coves for analytics-ready output."
 sidebar_position: 3
 ---
 

diff --git a/docs/best-practices/dbt/object-naming.md b/docs/best-practices/dbt/object-naming.md
@@ -1,5 +1,7 @@
 ---
-title: Object Naming Standards
+title: dbt Object Naming Standards in Datacoves
+sidebar_label: Object Naming Standards
+description: "Naming conventions for dbt models, sources, tests, and macros in Datacoves to ensure consistency and maintainability across large data engineering teams."
 sidebar_position: 2
 ---
 

diff --git a/docs/best-practices/git/README.md b/docs/best-practices/git/README.md
@@ -1,5 +1,7 @@
 ---
-title: Git
+title: Git Best Practices for Datacoves Data Projects
+sidebar_label: Git
+description: "Best practices for using Git in Datacoves: branching strategies, commit conventions, and workflow recommendations for data engineering teams."
 sidebar_position: 3
 ---
 # Git Overview

diff --git a/docs/best-practices/snowflake/comparing-tables.md b/docs/best-practices/snowflake/comparing-tables.md
@@ -1,5 +1,7 @@
 ---
-title: Comparing Tables Across Environments
+title: Compare Snowflake Tables Across dbt Environments
+sidebar_label: Comparing Tables
+description: "How to compare row counts, column values, and data distributions across dev, staging, and production Snowflake environments in your dbt workflow."
 sidebar_position: 5
 ---
 

diff --git a/docs/best-practices/snowflake/security-model.md b/docs/best-practices/snowflake/security-model.md
@@ -1,5 +1,7 @@
 ---
-title: Security Model
+title: Snowflake Security Model for Datacoves Projects
+sidebar_label: Security Model
+description: "Best practices for Snowflake role-based access control, user management, and security configuration for data engineering teams using Datacoves."
 sidebar_position: 2
 ---
 

diff --git a/docs/best-practices/snowflake/time-travel.md b/docs/best-practices/snowflake/time-travel.md
@@ -1,5 +1,7 @@
 ---
-title: GDPR and Time-Travel
+title: Snowflake Time Travel & GDPR Best Practices
+sidebar_label: Time Travel & GDPR
+description: "How to use Snowflake Time Travel for data recovery while managing GDPR compliance, including data retention policies and personal data handling guidance."
 sidebar_position: 3
 ---
 

diff --git a/docs/best-practices/vscode/README.md b/docs/best-practices/vscode/README.md
@@ -1,5 +1,7 @@
 ---
-title: VS Code
+title: VS Code Best Practices for Datacoves Developers
+sidebar_label: VS Code
+description: "Tips and best practices for using VS Code in the Datacoves Transform tab, including extensions, settings, and productivity recommendations for dbt teams."
 sidebar_position: 5
 ---
 # VS Code Best Practices and Tips
diff --git a/docs/best-practices/vscode/tips.md b/docs/best-practices/vscode/tips.md
@@ -1,5 +1,7 @@
 ---
-title: VS Code Tips
+title: VS Code Tips and Tricks for Datacoves Users
+sidebar_label: Tips & Tricks
+description: "Productivity tips and keyboard shortcuts for VS Code in Datacoves: navigation, multi-cursor editing, terminal tricks, and dbt workflow optimizations."
 sidebar_position: 138
 ---
 # VS Code Tips and tricks