dataroaring opened a new pull request, #3941:
URL: https://github.com/apache/doris-website/pull/3941

   ## What
   
   Rewrite the top of Table Design > Indexes > Index Overview to be 
default-first:
   
   - **Lead with what every table already has**: an automatic prefix index on 
the sort key and a ZoneMap index on every column.
   - **Add a decision table** mapping query pattern → recommended index → "when 
needed" (Always / Often / Sometimes / Rarely), so a reader can tell which 
indexes are foundational versus situational.
   - **Rename** "Choosing an Index by Query Scenario" to "How Each Index 
Works", since selection now happens in the table up front and that section is 
the deeper explanation.
   
   ## Why
   
   The page previously opened with a prose "Quick Selection Guide" and then 
four scenario explanations, without stating that two useful indexes already 
exist by default. A reader could not quickly tell whether they need to add 
anything. Leading with "you already have prefix + ZoneMap; add a manual index 
only when a pattern is not covered" matches how an experienced user actually 
decides.
   
   ## Scope
   
   - English only.
   - Applies to both current docs (`docs/`) and `versioned_docs/version-4.x`.
   - No new files, no sidebar changes; the page id is unchanged.
   - The in-page anchor reference in "Index Design Principles" was updated to 
point at the new "Start Here" section.


-- 
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]

Reply via email to