rilldata · royendo · Aug 8, 2025 · Aug 8, 2025 · Aug 8, 2025 · Aug 8, 2025
diff --git a/docs/docs/build/index.md b/docs/docs/build/index.md
@@ -0,0 +1,29 @@
+---
+title: Building Your Data Analytics Pipeline in Rill 
+sidebar_label: Build
+sidebar_position: 00
+---
+
+Rill provides a comprehensive platform for building end-to-end data analytics solutions. Once you've connected to your source data, or connected to your own OLAP database, you can start building with Rill. Don't forget to check out the [reference documentation!](/reference/project-files/)
+
+### Modeling and Last Mile ETL
+- [**SQL Models**](/build/models) - Transform and prepare your data
+- [**Data Refresh**](/build/models/source-refresh) - Schedule your data refresh  
+- [**Additional Model Templating**](/build/models/environments) - Separate your prod and dev settings 
+- [**Advanced Modeling**](/build/advanced-models) - Incremental ingestion, data partitions and more
+
+### Define Measures and Dimensions
+- [**Define Measures and Dimensions**](/build/metrics-view) - Define measures and dimensions 
+- [**Advanced Measures**](/build/metrics-view/advanced-expressions) - Aggregate further in your metrics view
+<!-- - [Define Data Access](#asd) - Define access and row access policies -->
+
+### Build Visualizations
+
+- [**Slice-and-Dice Dashboard**](/build/dashboards) - Explore and find insights in your data
+- [**Traditional Visualizations**](/build/canvas) - Visualize your data with various chart types
+
+### Project Settings
+- [**rill.yaml**](/build/rill-project-file) - Configure your Rill project defaults
+- [**Structure your Project**](/build/structure) - Structure folder architecture in Rill
+- [**Debugging Rill Developer**](/build/debugging/trace-viewer) - Trace your reconciled resources to troubleshoot issues
+
diff --git a/docs/docs/deploy/index.md b/docs/docs/deploy/index.md
@@ -0,0 +1,27 @@
+---
+title: Publish your Dashboards to Rill Cloud
+sidebar_label: Publish
+sidebar_position: 00
+---
+
+import TileIcon from '@site/src/components/TileIcon';
+
+Rill Developer is a great tool for building, testing, and viewing your data locally but once your ready to share your findings you'll need to publish the dashboard to Rill Cloud! To understand the differences, see [Rill Developer vs Rill Cloud](/home/concepts/cloud-vs-developer).
+
+
+### Credentials
+- [**Deployment Credentials**](/deploy/deploy-credentials) - Confirm deployment credentials based on your deployment environment
+
+### Deployment
+- [**Deploy your Dashboard**](/deploy/deploy-dashboard) - Publish your dashboard to Rill Cloud
+- [**GitHub Basics**](/deploy/deploy-dashboard/github-101) - GitHub basics to get you started
+
+### Post-Deployment Steps
+- [**Performance Optimization**](/deploy/performance) - Get better performance out of your dashboards
+- [**Managing Project Errors**](/deploy/project-errors) - Troubleshooting errors in Rill Cloud
+
+
+:::tip  first time Publishing?
+Publishing your dashboard to Rill for the first time will prompt you to register or login and will automatically start you 30 day free trial! We'll handle all the small setup things that are needed but you can change these at any time.
+
+:::
diff --git a/docs/docs/explore/index.md b/docs/docs/explore/index.md
@@ -0,0 +1,28 @@
+---
+title: Explore your Data in Rill 
+sidebar_label: Explore
+sidebar_position: 00
+---
+
+# Explore Your Data in Rill
+
+Once you've built your data pipeline, Rill provides powerful tools to explore, analyze, and share your insights.
+
+### AI-Powered Analysis
+
+- **[Natural Language Queries (MCP)](/explore/mcp)** - Ask questions about your data using plain English with Claude integration
+<!-- - **[AI Chat in Rill Cloud](/explore/ai-chat)** - Have conversations with your data using AI-powered chat interface -->
+
+### Interactive Dashboards
+
+- **[Slice-and-Dice Explore Dashboards](/explore/dashboard-101)** - Interactive dashboards for dynamic data exploration and filtering
+- **[Time Dimension Details](/explore/dashboard-101/tdd)** - Drill down into time-based analysis
+- **[Pivot Tables](/explore/dashboard-101/pivot)** - Create cross-tabulations and data summaries
+- **[Filtering](/explore/filters)** - Apply filters to focus on specific data subsets
+<!-- - **[Traditional Canvas Dashboards](/explore/canvas-dashboards)** - Custom dashboard layouts with Vega-Lite visualizations -->
+
+### Cloud Features
+- **[Bookmarks & Sharing](/explore/bookmarks)** - Save and share specific dashboard views and filters
+- **[Share with External Users](/explore/public-url)** - Invite external users and control their access to your dashboards
+- **[Exports and Scheduled Reports](/explore/exports)** - Export data and set up automated report delivery
+- **[Alerts](/explore/alerts)** - Set up notifications when data meets certain conditions
diff --git a/docs/docs/guides/index.md b/docs/docs/guides/index.md
@@ -20,9 +20,19 @@ Here at Rill, we believe in business-speed visual analytics. Gone are the days o
 ---
 Follow along, refer to the in-line linked documentation, and explore our product to make the most out of these guides! Please reach out to ask any questions or provide feedback on our Community Slack or Discord!
 
-- [**6 Steps to Rill Cloud:**](/guides/rill-basics/launch) Learn the basics, understand the core concepts of Rill, and deploy to Cloud!
-- [**Rill + ClickHouse:**](/guides/rill-clickhouse) For our friends from **ClickHouse**, we have created a dedicated course that goes over the same topics as Rill Basics! After completing, you can continue to Rill Advanced.
-- **Explore the Various Guides:** Explore the various guides on how to use Rill to the maximum capability and get the most out of our platform!
+- [**Source to Published Dashboard:**](/guides/rill-basics/launch) Learn the basics, understand the core concepts of Rill, and deploy to Cloud!
+- [**Visualize ClickHouse tables in Rill:**](/guides/rill-clickhouse) For our friends from **ClickHouse**, we have created a dedicated course using ClickHouse!
+- [**Clone a Project:**](/guides/) Step-by-step guide to clone an already deployed instance from Rill Cloud to your local machine
+- [**GitHub Analytics:**](/guides/) Analyze your own GitHub repository by modifying the python file, download_commits.py
+- [**Cost Monitornig Analytics:**](/guides/) Analyze your cost and usage data
+- [**OpenRTB Analytics:**](/guides/) Analyze real-time bidding data to track impressions, bids, wins and more.
+
+<!-- - [**Rill + MotherDuck:**](
+
+/guides/rill-motherduck) For our friends from **MotherDuck**, we have created a dedicated course using MotherDuck! -->
+<!-- - **Explore the Various Guides:** Explore the various guides on how to use Rill to the maximum capability and get the most out of our platform! -->
+<!-- - [**GA4 Analytics:**](/guides/) text
+- [**Logging Analytics:**](/guides/) text -->
 
 Each section is crafted to ensure a smooth and comprehensive learning experience. Happy learning!
 

diff --git a/docs/docs/integrate/index.md b/docs/docs/integrate/index.md
@@ -0,0 +1,22 @@
+---
+title: Integrate Rill into your Application
+sidebar_label: Integrate
+sidebar_position: 00
+---
+
+Extend Rill's capabilities by integrating dashboards and data into your existing applications and workflows.
+
+## Embed Rill into your Application
+
+- **[Embed Dashboards](/integrate/embedding)** - Embed Rill dashboards directly into your applications using iframes
+- **[Control your Embedded Dashboards](/integrate/embed-iframe-api)** - Programmatically control embedded dashboards from your application
+- **[See it in Action](https://rill-embedding-example.netlify.app/)** - View a live example of embedded Rill dashboards
+
+
+
+## Custom APIs
+
+- **[Create Custom APIs](/integrate/custom-api)** - Build custom APIs to retrieve aggregated data from your metrics views
+- **[Types of APIs](/integrate/custom-apis)** - See the different types of APIs to build
+
+
diff --git a/docs/docs/manage/index.md b/docs/docs/manage/index.md
@@ -0,0 +1,22 @@
+---
+title: Manage your Rill Cloud Project
+sidebar_label: Manage
+sidebar_position: 00
+---
+
+# Manage your Rill Cloud Project
+
+Administer your Rill Cloud project, manage users, and configure access controls.
+
+## Project Management
+
+- **[Organization Management](/manage/organization-management)** - Manage your organization settings and configuration
+- **[Project Management](/manage/project-management)** - Configure project settings and manage project resources
+- **[User Management](/manage/user-management)** - Invite, manage, and configure user access to your projects
+- **[User Group Management](/manage/usergroup-management)** - Create and manage user groups for easier access control-
+
+## Access Control
+
+- **[Dashboard Access Policies](/manage/security)** - Configure granular access controls for your dashboards and data
+- **[Roles and Permissions](/manage/roles-permissions)** - Set up user roles and define permission levels
+