Skip to content

Commit 20404cb

Browse files
authored
Docs data modeling improvements (#10698)
* docs: add dedicated Views guide page and minor fixes Add a new guide-level Views page to the Data Modeling section, covering why views matter, how they work, design best practices, and folder organization. Also hide the calendar cubes section in dimensions reference, fix the `id` named format to omit grouping commas, and remove the demo deployment callout from the getting started page. Made-with: Cursor * docs: restructure data modeling section into standalone pages - Create dedicated pages: Cubes, Joins, Measures, Dimensions - Move multi-fact queries under Views as "Multi-fact views" - Move extending cubes under Cubes as "Extending cubes" - Move polymorphic cubes to recipes - Move Syntax to standalone page after AI context - Rewrite Joins page with views-first approach - Rewrite multi-fact page to lead with the problem - Remove old Concepts index page, calculated-members, multi-stage-calculations - Hide data-blending page - Update all cross-references across 30+ files Made-with: Cursor
1 parent 867a236 commit 20404cb

41 files changed

Lines changed: 2749 additions & 4824 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

docs-mintlify/docs.json

Lines changed: 16 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -81,20 +81,24 @@
8181
"pages": [
8282
"docs/data-modeling/overview",
8383
{
84-
"group": "Concepts",
85-
"root": "docs/data-modeling/concepts/index",
84+
"group": "Views",
85+
"root": "docs/data-modeling/views",
8686
"pages": [
87-
"docs/data-modeling/concepts/syntax",
88-
"docs/data-modeling/concepts/calculated-members",
89-
"docs/data-modeling/concepts/multi-stage-calculations",
90-
"docs/data-modeling/concepts/working-with-joins",
91-
"docs/data-modeling/concepts/code-reusability-extending-cubes",
92-
"docs/data-modeling/concepts/polymorphic-cubes",
93-
"docs/data-modeling/concepts/multi-fact-queries",
94-
"docs/data-modeling/concepts/data-blending"
87+
"docs/data-modeling/multi-fact-views"
9588
]
9689
},
90+
{
91+
"group": "Cubes",
92+
"root": "docs/data-modeling/cubes",
93+
"pages": [
94+
"docs/data-modeling/extending-cubes"
95+
]
96+
},
97+
"docs/data-modeling/joins",
98+
"docs/data-modeling/measures",
99+
"docs/data-modeling/dimensions",
97100
"docs/data-modeling/ai-context",
101+
"docs/data-modeling/concepts/syntax",
98102
{
99103
"group": "Access Control",
100104
"pages": [
@@ -585,7 +589,8 @@
585589
"recipes/data-modeling/cohort-retention",
586590
"recipes/data-modeling/xirr",
587591
"recipes/data-modeling/dbt",
588-
"recipes/data-modeling/custom-order"
592+
"recipes/data-modeling/custom-order",
593+
"recipes/data-modeling/polymorphic-cubes"
589594
]
590595
}
591596
]

docs-mintlify/docs/data-modeling/access-control/member-level-security.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -145,8 +145,8 @@ them entirely, see [data masking][ref-data-masking] in access policies.
145145

146146
[ref-data-modeling-concepts]: /docs/data-modeling/concepts
147147
[ref-apis]: /reference
148-
[ref-cubes]: /docs/data-modeling/concepts#cubes
149-
[ref-views]: /docs/data-modeling/concepts#views
148+
[ref-cubes]: /docs/data-modeling/cubes
149+
[ref-views]: /docs/data-modeling/views
150150
[ref-dap]: /docs/data-modeling/access-control/data-access-policies
151151
[ref-ref-cubes]: /reference/data-modeling/cube
152152
[ref-ref-views]: /reference/data-modeling/view

docs-mintlify/docs/data-modeling/access-control/row-level-security.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -65,8 +65,8 @@ cube(`orders`, {
6565

6666
[ref-data-modeling-concepts]: /docs/data-modeling/concepts
6767
[ref-apis]: /reference
68-
[ref-cubes]: /docs/data-modeling/concepts#cubes
69-
[ref-views]: /docs/data-modeling/concepts#views
68+
[ref-cubes]: /docs/data-modeling/cubes
69+
[ref-views]: /docs/data-modeling/views
7070
[ref-cubes-sql]: /reference/data-modeling/cube#sql
7171
[ref-dynamic-data-modeling]: /docs/data-modeling/dynamic
7272
[ref-dap]: /docs/data-modeling/access-control/data-access-policies

0 commit comments

Comments
 (0)