This is an automated email from the ASF dual-hosted git repository.
dataroaring pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/doris-website.git
The following commit(s) were added to refs/heads/master by this push:
new 679636a8e97 [doc] Reorganize performance docs into top-level sidebar
section (#3443)
679636a8e97 is described below
commit 679636a8e97354f0e717a3c360df52d0fe069572
Author: Yongqiang YANG <[email protected]>
AuthorDate: Mon Mar 9 18:26:20 2026 -0700
[doc] Reorganize performance docs into top-level sidebar section (#3443)
## Summary
- **Create new top-level "Performance" sidebar section** between Guides
and Benchmark, unifying all performance-related docs
- **Remove "Queries Acceleration"** from Guides (42 docs redistributed
by topic)
- **Remove "Load Internals"** from Guides > Loading Data (3 docs moved
to Load Performance)
- Sidebar-only change — no `.md` files were moved or modified
### New structure:
- Getting Started with Performance Tuning (4 docs)
- Query Performance (9 subcategories: Schema & Index Optimization,
Materialized View, Caching, Join Optimization, High Concurrency & Point
Queries, Distinct Counts, Hints, Execution Tuning, Query Profile &
Parameters)
- Load Performance (4 docs)
- Optimization Technology Principles (5 docs)
### Files changed:
- `sidebars.ts` (dev/latest)
- `versioned_sidebars/version-4.x-sidebars.json` (v4.x)
- `version-3.x` and `version-2.1` sidebars intentionally unchanged
## Test plan
- [ ] Run `yarn start` and verify new "Performance" top-level section
appears
- [ ] Verify "Queries Acceleration" no longer appears under Guides
- [ ] Verify "Load Internals" no longer appears under Guides > Loading
Data
- [ ] Click through all docs in new Performance section to confirm links
resolve
- [ ] Switch to version 4.x and verify same structure
- [ ] Verify Benchmark section unchanged
🤖 Generated with [Claude Code](https://claude.com/claude-code)
---------
Co-authored-by: Claude Opus 4.6 <[email protected]>
---
sidebars.ts | 251 +++++++++++++++------------
versioned_sidebars/version-4.x-sidebars.json | 249 ++++++++++++++------------
2 files changed, 281 insertions(+), 219 deletions(-)
diff --git a/sidebars.ts b/sidebars.ts
index 31f7044a02d..d18365229ad 100644
--- a/sidebars.ts
+++ b/sidebars.ts
@@ -222,21 +222,20 @@ const sidebars: SidebarsConfig = {
'data-operate/import/load-best-practices',
{
type: 'category',
- label: 'Load Internals',
+ label: 'Continuous Load',
items: [
-
'data-operate/import/load-internals/load-internals',
-
'data-operate/import/load-internals/routine-load-internals',
-
'data-operate/import/load-internals/stream-load-in-complex-network',
+
'data-operate/import/streaming-job/streaming-job-tvf',
+
'data-operate/import/streaming-job/streaming-job-multi-table',
],
},
{
type: 'category',
- label: 'Continuous Load',
+ label: 'Load Internals',
items: [
-
'data-operate/import/streaming-job/streaming-job-tvf',
-
'data-operate/import/streaming-job/streaming-job-multi-table',
+
'data-operate/import/load-internals/routine-load-internals',
+
'data-operate/import/load-internals/stream-load-in-complex-network',
],
- }
+ },
],
},
{
@@ -305,108 +304,6 @@ const sidebars: SidebarsConfig = {
'query-data/lateral-view',
],
},
- {
- type: 'category',
- label: 'Queries Acceleration',
- items: [
- {
- type: 'category',
- label: 'Performance Tuning Overview',
- items: [
-
'query-acceleration/performance-tuning-overview/tuning-overview',
-
'query-acceleration/performance-tuning-overview/diagnostic-tools',
-
'query-acceleration/performance-tuning-overview/analysis-tools',
-
'query-acceleration/performance-tuning-overview/tuning-process',
- ],
- },
- {
- type: 'category',
- label: 'Materialize View',
- items: [
-
'query-acceleration/materialized-view/overview',
-
'query-acceleration/materialized-view/sync-materialized-view',
- {
- type: 'category',
- label: 'Async-Materialized View',
- items: [
-
'query-acceleration/materialized-view/async-materialized-view/overview',
-
'query-acceleration/materialized-view/async-materialized-view/functions-and-demands',
-
'query-acceleration/materialized-view/async-materialized-view/use-guide',
-
'query-acceleration/materialized-view/async-materialized-view/use-advice',
-
'query-acceleration/materialized-view/async-materialized-view/faq',
- ],
- },
- ],
- },
- 'query-acceleration/sql-cache-manual',
- 'query-acceleration/condition-cache',
- 'query-acceleration/high-concurrent-point-query',
- 'query-acceleration/dictionary',
- 'query-acceleration/query-profile',
- {
- type: 'category',
- label: 'Distincting Counts',
- items: [
-
'query-acceleration/distinct-counts/bitmap-precise-deduplication',
-
'query-acceleration/distinct-counts/hll-approximate-deduplication',
- ],
- },
- 'query-acceleration/colocation-join',
- {
- type: 'category',
- label: 'Hints',
- items: [
- 'query-acceleration/hints/hints-overview',
- 'query-acceleration/hints/leading-hint',
- 'query-acceleration/hints/distribute-hint',
- ],
- },
- {
- type: 'category',
- label: 'Tuning',
- items: [
- {
- type: 'category',
- label: 'Tuning Plan',
- items: [
-
'query-acceleration/tuning/tuning-plan/optimizing-table-schema',
-
'query-acceleration/tuning/tuning-plan/optimizing-table-index',
-
'query-acceleration/tuning/tuning-plan/optimizing-table-scanning',
-
'query-acceleration/tuning/tuning-plan/transparent-rewriting-with-sync-mv',
-
'query-acceleration/tuning/tuning-plan/transparent-rewriting-with-async-mv',
-
'query-acceleration/tuning/tuning-plan/optimizing-join-with-colocate-group',
-
'query-acceleration/tuning/tuning-plan/adjusting-join-shuffle',
-
'query-acceleration/tuning/tuning-plan/controlling-hints-with-cbo-rule',
-
'query-acceleration/tuning/tuning-plan/reordering-join-with-leading-hint',
-
'query-acceleration/tuning/tuning-plan/accelerating-queries-with-sql-cache',
-
'query-acceleration/tuning/tuning-plan/dml-tuning-plan',
- ],
- },
- {
- type: 'category',
- label: 'Tuning Execution',
- items: [
-
'query-acceleration/tuning/tuning-execution/adjustment-of-runtimefilter-wait-time',
-
'query-acceleration/tuning/tuning-execution/data-skew-handling',
-
'query-acceleration/tuning/tuning-execution/parallelism-tuning',
- ],
- },
- 'query-acceleration/tuning/tuning-parameters',
- ],
- },
- {
- type: 'category',
- label: 'Optimization Technology Principle',
- items: [
-
'query-acceleration/optimization-technology-principle/query-optimizer',
-
'query-acceleration/optimization-technology-principle/pipeline-execution-engine',
-
'query-acceleration/optimization-technology-principle/runtime-filter',
-
'query-acceleration/optimization-technology-principle/topn-optimization',
-
'query-acceleration/optimization-technology-principle/statistics',
- ],
- },
- ],
- },
{
type: 'category',
label: 'AI',
@@ -667,6 +564,140 @@ const sidebars: SidebarsConfig = {
},
],
},
+ {
+ type: 'category',
+ label: 'Performance',
+ collapsed: false,
+ items: [
+ {
+ type: 'category',
+ label: 'Getting Started with Performance Tuning',
+ items: [
+
'query-acceleration/performance-tuning-overview/tuning-overview',
+
'query-acceleration/performance-tuning-overview/diagnostic-tools',
+
'query-acceleration/performance-tuning-overview/analysis-tools',
+
'query-acceleration/performance-tuning-overview/tuning-process',
+ ],
+ },
+ {
+ type: 'category',
+ label: 'Query Performance',
+ items: [
+ {
+ type: 'category',
+ label: 'Schema & Index Optimization',
+ items: [
+
'query-acceleration/tuning/tuning-plan/optimizing-table-schema',
+
'query-acceleration/tuning/tuning-plan/optimizing-table-index',
+
'query-acceleration/tuning/tuning-plan/optimizing-table-scanning',
+ ],
+ },
+ {
+ type: 'category',
+ label: 'Materialized View',
+ items: [
+
'query-acceleration/materialized-view/overview',
+
'query-acceleration/materialized-view/sync-materialized-view',
+
'query-acceleration/tuning/tuning-plan/transparent-rewriting-with-sync-mv',
+ {
+ type: 'category',
+ label: 'Async Materialized View',
+ items: [
+
'query-acceleration/materialized-view/async-materialized-view/overview',
+
'query-acceleration/materialized-view/async-materialized-view/functions-and-demands',
+
'query-acceleration/materialized-view/async-materialized-view/use-guide',
+
'query-acceleration/materialized-view/async-materialized-view/use-advice',
+
'query-acceleration/materialized-view/async-materialized-view/faq',
+
'query-acceleration/tuning/tuning-plan/transparent-rewriting-with-async-mv',
+ ],
+ },
+ ],
+ },
+ {
+ type: 'category',
+ label: 'Join Optimization',
+ items: [
+ 'query-acceleration/colocation-join',
+
'query-acceleration/tuning/tuning-plan/optimizing-join-with-colocate-group',
+
'query-acceleration/tuning/tuning-plan/adjusting-join-shuffle',
+
'query-acceleration/tuning/tuning-plan/reordering-join-with-leading-hint',
+ ],
+ },
+ {
+ type: 'category',
+ label: 'Caching',
+ items: [
+ 'query-acceleration/sql-cache-manual',
+ 'query-acceleration/condition-cache',
+
'query-acceleration/tuning/tuning-plan/accelerating-queries-with-sql-cache',
+ ],
+ },
+ {
+ type: 'category',
+ label: 'Execution Tuning',
+ items: [
+
'query-acceleration/tuning/tuning-execution/adjustment-of-runtimefilter-wait-time',
+
'query-acceleration/tuning/tuning-execution/data-skew-handling',
+
'query-acceleration/tuning/tuning-execution/parallelism-tuning',
+
'query-acceleration/tuning/tuning-plan/controlling-hints-with-cbo-rule',
+ ],
+ },
+ {
+ type: 'category',
+ label: 'High Concurrency & Point Queries',
+ items: [
+
'query-acceleration/high-concurrent-point-query',
+ 'query-acceleration/dictionary',
+ ],
+ },
+ {
+ type: 'category',
+ label: 'Distinct Counts',
+ items: [
+
'query-acceleration/distinct-counts/bitmap-precise-deduplication',
+
'query-acceleration/distinct-counts/hll-approximate-deduplication',
+ ],
+ },
+ {
+ type: 'category',
+ label: 'Hints',
+ items: [
+ 'query-acceleration/hints/hints-overview',
+ 'query-acceleration/hints/leading-hint',
+ 'query-acceleration/hints/distribute-hint',
+ ],
+ },
+ {
+ type: 'category',
+ label: 'Query Profile & Parameters',
+ items: [
+ 'query-acceleration/query-profile',
+ 'query-acceleration/tuning/tuning-parameters',
+ ],
+ },
+ ],
+ },
+ {
+ type: 'category',
+ label: 'Load Performance',
+ items: [
+ 'data-operate/import/load-internals/load-internals',
+
'query-acceleration/tuning/tuning-plan/dml-tuning-plan',
+ ],
+ },
+ {
+ type: 'category',
+ label: 'Optimization Technology Principles',
+ items: [
+
'query-acceleration/optimization-technology-principle/query-optimizer',
+
'query-acceleration/optimization-technology-principle/pipeline-execution-engine',
+
'query-acceleration/optimization-technology-principle/runtime-filter',
+
'query-acceleration/optimization-technology-principle/topn-optimization',
+
'query-acceleration/optimization-technology-principle/statistics',
+ ],
+ },
+ ],
+ },
{
type: 'category',
label: 'Benchmark',
diff --git a/versioned_sidebars/version-4.x-sidebars.json
b/versioned_sidebars/version-4.x-sidebars.json
index 59e7778d6ec..bb83007dc94 100644
--- a/versioned_sidebars/version-4.x-sidebars.json
+++ b/versioned_sidebars/version-4.x-sidebars.json
@@ -226,19 +226,18 @@
"data-operate/import/load-best-practices",
{
"type": "category",
- "label": "Load Internals",
+ "label": "Continuous Load",
"items": [
-
"data-operate/import/load-internals/load-internals",
-
"data-operate/import/load-internals/routine-load-internals",
-
"data-operate/import/load-internals/stream-load-in-complex-network"
+
"data-operate/import/streaming-job/streaming-job-tvf",
+
"data-operate/import/streaming-job/streaming-job-multi-table"
]
},
{
"type": "category",
- "label": "Continuous Load",
+ "label": "Load Internals",
"items": [
-
"data-operate/import/streaming-job/streaming-job-tvf",
-
"data-operate/import/streaming-job/streaming-job-multi-table"
+
"data-operate/import/load-internals/routine-load-internals",
+
"data-operate/import/load-internals/stream-load-in-complex-network"
]
}
]
@@ -307,108 +306,6 @@
"query-data/lateral-view"
]
},
- {
- "type": "category",
- "label": "Queries Acceleration",
- "items": [
- {
- "type": "category",
- "label": "Performance Tuning Overview",
- "items": [
-
"query-acceleration/performance-tuning-overview/tuning-overview",
-
"query-acceleration/performance-tuning-overview/diagnostic-tools",
-
"query-acceleration/performance-tuning-overview/analysis-tools",
-
"query-acceleration/performance-tuning-overview/tuning-process"
- ]
- },
- {
- "type": "category",
- "label": "Materialize View",
- "items": [
-
"query-acceleration/materialized-view/overview",
-
"query-acceleration/materialized-view/sync-materialized-view",
- {
- "type": "category",
- "label": "Async-Materialized View",
- "items": [
-
"query-acceleration/materialized-view/async-materialized-view/overview",
-
"query-acceleration/materialized-view/async-materialized-view/functions-and-demands",
-
"query-acceleration/materialized-view/async-materialized-view/use-guide",
-
"query-acceleration/materialized-view/async-materialized-view/use-advice",
-
"query-acceleration/materialized-view/async-materialized-view/faq"
- ]
- }
- ]
- },
- "query-acceleration/sql-cache-manual",
- "query-acceleration/condition-cache",
- "query-acceleration/high-concurrent-point-query",
- "query-acceleration/dictionary",
- "query-acceleration/query-profile",
- {
- "type": "category",
- "label": "Distincting Counts",
- "items": [
-
"query-acceleration/distinct-counts/bitmap-precise-deduplication",
-
"query-acceleration/distinct-counts/hll-approximate-deduplication"
- ]
- },
- "query-acceleration/colocation-join",
- {
- "type": "category",
- "label": "Hints",
- "items": [
- "query-acceleration/hints/hints-overview",
- "query-acceleration/hints/leading-hint",
- "query-acceleration/hints/distribute-hint"
- ]
- },
- {
- "type": "category",
- "label": "Tuning",
- "items": [
- {
- "type": "category",
- "label": "Tuning Plan",
- "items": [
-
"query-acceleration/tuning/tuning-plan/optimizing-table-schema",
-
"query-acceleration/tuning/tuning-plan/optimizing-table-index",
-
"query-acceleration/tuning/tuning-plan/optimizing-table-scanning",
-
"query-acceleration/tuning/tuning-plan/transparent-rewriting-with-sync-mv",
-
"query-acceleration/tuning/tuning-plan/transparent-rewriting-with-async-mv",
-
"query-acceleration/tuning/tuning-plan/optimizing-join-with-colocate-group",
-
"query-acceleration/tuning/tuning-plan/adjusting-join-shuffle",
-
"query-acceleration/tuning/tuning-plan/controlling-hints-with-cbo-rule",
-
"query-acceleration/tuning/tuning-plan/reordering-join-with-leading-hint",
-
"query-acceleration/tuning/tuning-plan/accelerating-queries-with-sql-cache",
-
"query-acceleration/tuning/tuning-plan/dml-tuning-plan"
- ]
- },
- {
- "type": "category",
- "label": "Tuning Execution",
- "items": [
-
"query-acceleration/tuning/tuning-execution/adjustment-of-runtimefilter-wait-time",
-
"query-acceleration/tuning/tuning-execution/data-skew-handling",
-
"query-acceleration/tuning/tuning-execution/parallelism-tuning"
- ]
- },
- "query-acceleration/tuning/tuning-parameters"
- ]
- },
- {
- "type": "category",
- "label": "Optimization Technology Principle",
- "items": [
-
"query-acceleration/optimization-technology-principle/query-optimizer",
-
"query-acceleration/optimization-technology-principle/pipeline-execution-engine",
-
"query-acceleration/optimization-technology-principle/runtime-filter",
-
"query-acceleration/optimization-technology-principle/topn-optimization",
-
"query-acceleration/optimization-technology-principle/statistics"
- ]
- }
- ]
- },
{
"type": "category",
"label": "AI",
@@ -671,6 +568,140 @@
}
]
},
+ {
+ "type": "category",
+ "label": "Performance",
+ "collapsed": false,
+ "items": [
+ {
+ "type": "category",
+ "label": "Getting Started with Performance Tuning",
+ "items": [
+
"query-acceleration/performance-tuning-overview/tuning-overview",
+
"query-acceleration/performance-tuning-overview/diagnostic-tools",
+
"query-acceleration/performance-tuning-overview/analysis-tools",
+
"query-acceleration/performance-tuning-overview/tuning-process"
+ ]
+ },
+ {
+ "type": "category",
+ "label": "Query Performance",
+ "items": [
+ {
+ "type": "category",
+ "label": "Schema & Index Optimization",
+ "items": [
+
"query-acceleration/tuning/tuning-plan/optimizing-table-schema",
+
"query-acceleration/tuning/tuning-plan/optimizing-table-index",
+
"query-acceleration/tuning/tuning-plan/optimizing-table-scanning"
+ ]
+ },
+ {
+ "type": "category",
+ "label": "Materialized View",
+ "items": [
+
"query-acceleration/materialized-view/overview",
+
"query-acceleration/materialized-view/sync-materialized-view",
+
"query-acceleration/tuning/tuning-plan/transparent-rewriting-with-sync-mv",
+ {
+ "type": "category",
+ "label": "Async Materialized View",
+ "items": [
+
"query-acceleration/materialized-view/async-materialized-view/overview",
+
"query-acceleration/materialized-view/async-materialized-view/functions-and-demands",
+
"query-acceleration/materialized-view/async-materialized-view/use-guide",
+
"query-acceleration/materialized-view/async-materialized-view/use-advice",
+
"query-acceleration/materialized-view/async-materialized-view/faq",
+
"query-acceleration/tuning/tuning-plan/transparent-rewriting-with-async-mv"
+ ]
+ }
+ ]
+ },
+ {
+ "type": "category",
+ "label": "Join Optimization",
+ "items": [
+ "query-acceleration/colocation-join",
+
"query-acceleration/tuning/tuning-plan/optimizing-join-with-colocate-group",
+
"query-acceleration/tuning/tuning-plan/adjusting-join-shuffle",
+
"query-acceleration/tuning/tuning-plan/reordering-join-with-leading-hint"
+ ]
+ },
+ {
+ "type": "category",
+ "label": "Caching",
+ "items": [
+ "query-acceleration/sql-cache-manual",
+ "query-acceleration/condition-cache",
+
"query-acceleration/tuning/tuning-plan/accelerating-queries-with-sql-cache"
+ ]
+ },
+ {
+ "type": "category",
+ "label": "Execution Tuning",
+ "items": [
+
"query-acceleration/tuning/tuning-execution/adjustment-of-runtimefilter-wait-time",
+
"query-acceleration/tuning/tuning-execution/data-skew-handling",
+
"query-acceleration/tuning/tuning-execution/parallelism-tuning",
+
"query-acceleration/tuning/tuning-plan/controlling-hints-with-cbo-rule"
+ ]
+ },
+ {
+ "type": "category",
+ "label": "High Concurrency & Point Queries",
+ "items": [
+
"query-acceleration/high-concurrent-point-query",
+ "query-acceleration/dictionary"
+ ]
+ },
+ {
+ "type": "category",
+ "label": "Distinct Counts",
+ "items": [
+
"query-acceleration/distinct-counts/bitmap-precise-deduplication",
+
"query-acceleration/distinct-counts/hll-approximate-deduplication"
+ ]
+ },
+ {
+ "type": "category",
+ "label": "Hints",
+ "items": [
+ "query-acceleration/hints/hints-overview",
+ "query-acceleration/hints/leading-hint",
+ "query-acceleration/hints/distribute-hint"
+ ]
+ },
+ {
+ "type": "category",
+ "label": "Query Profile & Parameters",
+ "items": [
+ "query-acceleration/query-profile",
+ "query-acceleration/tuning/tuning-parameters"
+ ]
+ }
+ ]
+ },
+ {
+ "type": "category",
+ "label": "Load Performance",
+ "items": [
+ "data-operate/import/load-internals/load-internals",
+ "query-acceleration/tuning/tuning-plan/dml-tuning-plan"
+ ]
+ },
+ {
+ "type": "category",
+ "label": "Optimization Technology Principles",
+ "items": [
+
"query-acceleration/optimization-technology-principle/query-optimizer",
+
"query-acceleration/optimization-technology-principle/pipeline-execution-engine",
+
"query-acceleration/optimization-technology-principle/runtime-filter",
+
"query-acceleration/optimization-technology-principle/topn-optimization",
+
"query-acceleration/optimization-technology-principle/statistics"
+ ]
+ }
+ ]
+ },
{
"type": "category",
"label": "Benchmark",
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
