[docs] platform core concept revamp and overview update (#3664)

2025-10-26 15:15:13 +05:30
parent 61faf71064
commit 2c18355dd2
19 changed files with 595 additions and 318 deletions
@@ -15,6 +15,7 @@ Cookbooks are narrative tutorials. They start with a real problem, show the brok
 - Keep tone conversational; use real names ("Max", "Sarah"), not `user_123`.
 - Opening must stay tight: ≤2 short paragraphs (no bullet lists) before the first section.
 - Inline expected outputs immediately after each code block.
+- When modernizing an existing cookbook, keep the narrative beats, screenshots, and sample outputs—reshape them into this arc instead of rewriting unless the workflow changed.
 - Limit callouts to 3–5 per page. Prefer narrative text over stacked boxes.
 - Always provide Python **and** TypeScript tabs when an SDK exists for both.
 - Every page must end with exactly two navigation cards (left = related/side quest, right = next cookbook in the journey).