From 0d920e4d609dd69289b5aa9ba9544e8c43c87686 Mon Sep 17 00:00:00 2001 From: Syed Fahad Date: Wed, 18 Nov 2026 02:14:48 +0530 Subject: [PATCH] say ask can answer overview questions from the wiki --- platform/ask.mdx | 11 +++++++---- platform/wiki.mdx | 2 +- 2 files changed, 8 insertions(+), 5 deletions(-) diff --git a/platform/ask.mdx b/platform/ask.mdx index 927cf24..3294472 100644 --- a/platform/ask.mdx +++ b/platform/ask.mdx @@ -1,7 +1,7 @@ --- title: "Ask your codebase: answers with citations" sidebarTitle: "Ask" -description: "Ask your codebase plain-language questions. Graphify answers with cited graph nodes and paths, handles PR questions, and abstains without a path." +description: "Ask your codebase plain-language questions. Graphify answers from the graph or the wiki, handles PR questions, and abstains when it has no answer." keywords: ["graphify ask", "ask your codebase", "grounded code answers", "plan a change"] surface: "cloud" icon: "message-square-text" @@ -9,7 +9,7 @@ icon: "message-square-text" import HostedMcpCard from '/snippets/hosted-mcp-card.mdx'; -**Ask** is where you question a repository in plain language. Graphify answers from the code knowledge graph of that repository, not from a model's guess: every answer cites the nodes it used and the path it followed. When the graph has no path that answers your question, Ask tells you it found no answer instead of inventing one. +**Ask** is where you question a repository in plain language. Graphify answers from the code knowledge graph of that repository, not from a model's guess: every answer cites the nodes it used and the path it followed. Overview questions, such as what the repository is about or how it's structured, can be answered from the [wiki](/platform/wiki) first, and are labeled **From the repo wiki**. When neither the graph nor the wiki supports an answer, Ask tells you it found no answer instead of inventing one. **Use Ask when** you want to know who owns some behavior, how two parts of the code connect, or where something actually lives, before you open an editor. @@ -58,9 +58,10 @@ import HostedMcpCard from '/snippets/hosted-mcp-card.mdx'; - **Pull request questions.** Mention `#1234`, `PR 1234`, or a pull request URL. Ask answers from that pull request's completed review. - **Task descriptions.** Paste a task, such as a ticket body. Ask returns guidance on where the change goes. +- **Overview questions.** Questions about the repository as a whole, such as what it's about or how it's structured, can be answered from the wiki. - **Code questions.** Everything else. Ask searches the graph and cites the nodes it used. -Each answer has prose, citations, and graph paths. When no grounded path exists, the answer abstains. That's a normal answer, not an error. +Each code answer has prose, citations, and graph paths. Wiki answers are labeled **From the repo wiki** and list the **Wiki pages** they used. When no grounded path or wiki page supports an answer, Ask abstains. That's a normal answer, not an error. ## Memories on an Ask answer @@ -77,7 +78,9 @@ Ask reads the URL, so you can share a question or open a mode directly: ## When Ask has no answer -**No answer found for this question** means the graph has no path that supports an answer. This is deliberate: a near-miss is reported as no answer rather than a confident guess. To get an answer: +When a question has no grounded answer, Ask says **I couldn't match that to specific code in [repository]. Try naming a function, file, or feature.** If code was found but still couldn't be turned into an answer, it says **I couldn't answer that from the code in [repository]. Try rephrasing, or name a function, file, or feature.** When the repository has a wiki, either reply ends with **, or check the Wiki for an overview**, and **the Wiki** links to it. + +This is deliberate: a near-miss is reported as no answer rather than a confident guess. To get an answer: - Name a real symbol, file, or module. - Ask about one relationship at a time. diff --git a/platform/wiki.mdx b/platform/wiki.mdx index b34f2b7..fd5b2ba 100644 --- a/platform/wiki.mdx +++ b/platform/wiki.mdx @@ -56,7 +56,7 @@ A wiki built before subsystems were added keeps its older sidebar, grouped by fo ## Ask the wiki -Select **Ask the wiki** (or **Ask about this project**) and type what you'd like to understand. Answers draw on the same graph as the wiki. For questions about one function or call path, [Ask](/platform/ask) is more direct. +Select **Ask the wiki** (or **Ask about this project**) and type what you'd like to understand. Answers draw on the same graph as the wiki. For questions about one function or call path, [Ask](/platform/ask) is more direct. Overview questions asked from Ask can also be answered from the wiki, and those answers are labeled **From the repo wiki**. ## Large repositories