Skip to content

Commit 34314b8

Browse files
committed
docs: rewrite weak Ask AI callout prompts and remove devkey routing prompt
Audited all 19 [!ASKAI] callouts by firing each against the prod /docs/ask endpoint and grading the response. Five callouts produced low-value answers (page paraphrase, dangling "this" referent, or AI admitting it lacked the information); one was a duplicate. - guide/integration/devkey: remove vue-router prompt (AI replied "I don't have information about this") - guide/tooling/vuetify-cli: reframe analyze prompt around output + team sharing rather than the leading "migration planning" framing - guide/tooling/ai-tools: shift llms.txt prompt to agent configuration (the comparison table directly above the callout already covers llms.txt vs llms-full.txt) - guide/fundamentals/composables: replace generic when-to-use prompt with a concrete Selection -> createSelection conversion request - guide/fundamentals/building-frameworks: fix dangling "this" referent by naming createSingle + useProxyRegistry explicitly - guide/essentials/using-the-docs: replace duplicate createSelection vs createGroup prompt with composable-discovery question
1 parent 6100ea0 commit 34314b8

6 files changed

Lines changed: 5 additions & 7 deletions

File tree

apps/docs/src/pages/guide/essentials/using-the-docs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -440,7 +440,7 @@ The documentation uses callout boxes to highlight important information:
440440
441441
> [!WARNING] Cautions and common mistakes to avoid.
442442
443-
> [!ASKAI] What's the difference between createSelection and createGroup?
443+
> [!ASKAI] How do I find the right composable for what I'm building?
444444
445445
> [!TOUR] using-the-docs
446446

apps/docs/src/pages/guide/fundamentals/building-frameworks.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -198,7 +198,7 @@ Accordion with expand/collapse-all using `createGroup` and tri-state support.
198198

199199
:::
200200

201-
> [!ASKAI] How does this compare to v0's built-in Tabs component?
201+
> [!ASKAI] How does building a Tabs UI manually with createSingle and useProxyRegistry compare to v0's built-in Tabs component?
202202
203203
## Pattern B: Component Wrappers
204204

apps/docs/src/pages/guide/fundamentals/composables.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ selection.select('a')
5151
> [!TIP]
5252
> Components and composables are interchangeable. Every component uses a composable internally—you can always drop to the composable for more control.
5353
54-
> [!ASKAI] How do I choose between composables and components for my use case?
54+
> [!ASKAI] Show me how to convert a Selection component usage to createSelection while keeping the same behavior.
5555
5656
## Quick Reactivity Note
5757

apps/docs/src/pages/guide/integration/devkey.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -159,5 +159,3 @@ Once DevKey is running locally, explore the pieces it relies on:
159159
| Build your own components on top of v0 | [Building Frameworks](/guide/fundamentals/building-frameworks) |
160160
| Customize the theme | [Theming](/guide/features/theming) |
161161
| Add SSR | [Nuxt](/guide/integration/nuxt) |
162-
163-
> [!ASKAI] How do I add a new page to DevKey with vue-router?

apps/docs/src/pages/guide/tooling/ai-tools.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ v0 provides machine-readable documentation files following the [llms.txt](https:
3333
| <a href="/llms-full.txt" target="_blank" class="v0-link whitespace-nowrap">llms-full.txt↗</a> | {{ llmsStats.llmsFull.sizeFormatted }} | Complete documentation | Deep understanding, code generation |
3434
| <a href="/SKILL.md" target="_blank" class="v0-link">SKILL.md↗</a> | ~5KB | Patterns & anti-patterns | Claude Code, Cursor, Windsurf |
3535

36-
> [!ASKAI] When should I use llms.txt vs llms-full.txt?
36+
> [!ASKAI] How do I configure my AI agent to consume llms-full.txt?
3737
3838
## Usage
3939

apps/docs/src/pages/guide/tooling/vuetify-cli.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -308,7 +308,7 @@ Use `--reporter json` to integrate with CI/CD pipelines or custom tooling:
308308
vuetify analyze --reporter json --output report.json
309309
```
310310

311-
> [!ASKAI] How can I use the analyze command to plan a Vuetify migration?
311+
> [!ASKAI] What does the analyze command output and how do I share the report with my team?
312312
313313
### upgrade
314314

0 commit comments

Comments
 (0)