dataroaring opened a new pull request, #3940: URL: https://github.com/apache/doris-website/pull/3940
## What - **Add a default-first landing page** for Table Design > Partitioning & Bucketing. It opens with a recommended `CREATE TABLE` (auto partition by time + `BUCKETS AUTO`), a "when to customize" decision table, and links to the how-tos. - **Make it the category landing** (was the 37KB `basic-concepts` page). - **Reorder the how-tos default-first**: auto, then dynamic, then manual (manual was listed first). - **Repurpose `basic-concepts`** as the "How It Works" explanation page it already is (title + intro updated; body unchanged). ## Why The section previously opened on `basic-concepts` (~37KB), which mixes core concepts, the first `CREATE TABLE`, advanced modes, design recommendations, and operations in one page. A reader who just wants a sensible partitioning setup had to read the full model first, and the sidebar surfaced the most manual option (manual partitioning) before the recommended automated one. Leading with a recommended default and a short decision guide gets users to a working, well-distributed table quickly, while the full model stays one click away in the dedicated explanation page. ## Scope - English only. - Applies to both current docs (`docs/`) and `versioned_docs/version-4.x`; both sidebars updated. - New doc id: `table-design/data-partitioning/overview`. - `basic-concepts` keeps its URL (still linked from the landing and the how-tos), so no links break. - Deeper de-duplication (advanced partition/bucket sections in `basic-concepts` vs the auto/dynamic/manual/bucketing pages) is intentionally left for a follow-up, since it needs section-by-section verification before removing content. ## Validation - `version-4.x-sidebars.json` parses as valid JSON. - All six referenced doc ids resolve to files. - Recommended `CREATE TABLE` uses the documented `AUTO PARTITION BY RANGE (date_trunc(...))` + `BUCKETS AUTO` syntax. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
