Skip to content

Commit 171890d

Browse files
committed
docs(search): consolidate example prompts into core guides
1 parent bd3bdeb commit 171890d

6 files changed

Lines changed: 16 additions & 110 deletions

File tree

‎apps/docs/content/docs/search/ask-questions.mdx‎

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -62,10 +62,16 @@ Specify what you want extracted, rather than just “summarize this.”
6262

6363
| Task | Example prompt |
6464
| --- | --- |
65-
| Compare options | “Compare the two onboarding proposals in a table: scope, effort, risks, and dependencies. Cite each source.” |
66-
| Catch up on a project | “What decisions were recorded for Atlas this month? Separate agreed decisions from suggestions.” |
65+
| Compare options | “Compare these two vendor proposals against our evaluation requirements. Cite the evidence and distinguish missing information from requirements a vendor does not meet.” |
66+
| Catch up on a project | “Summarize Atlas updates from the past two weeks. Separate decisions, blockers, and next steps. Include owners only where the sources name them, and cite each item.” |
6767
| Find an owner | “Who owns the launch checklist? Cite the document that assigns responsibility.” |
6868
| Resolve a disagreement | “These documents give different dates. Compare their context and identify what is confirmed.” |
69+
| Understand a decision | “Find the decision about Atlas authentication. Summarize the options, chosen approach, and trade-offs. Distinguish final decisions from proposals and cite the decision record.” |
70+
| Find troubleshooting steps | “Find our SSO sign-in troubleshooting guide. Summarize the checks in order, cite the source, and identify when to escalate.” |
71+
| Understand a policy | “What does our travel policy say about hotels and meals? Cite the policy sections, identify regional differences, and flag cases it doesn't address.” |
72+
| Compare feedback with a proposal | “Compare onboarding feedback with the new proposal. Show each need, whether the proposal addresses it, and the supporting source. Mark gaps explicitly.” |
73+
74+
Follow up with “Which decisions changed an earlier plan?” or “Turn the gaps into questions for our review.”
6975

7076
If the sources don't assign an owner or confirm a date, ask Sim to say so. Include the timeframe you care about, and distinguish a document's update date from the event it describes. A live search is still subject to provider freshness and retrieval limits.
7177

@@ -110,11 +116,12 @@ Continue with specific revisions:
110116
- “Cut this to half the length without losing the action items or source links.”
111117
- “Separate confirmed facts from proposed next steps.”
112118
- “Use the tone of this approved example: [paste an example].”
119+
- “Turn this product overview into an FAQ for customer-facing teams. Cite each answer and list questions the overview doesn't resolve.”
113120
- “Turn this into a six-slide outline with a title, three key points, and supporting sources for each slide.”
114121

115122
Provide a style example or brand guidance when consistency matters. Check names, numbers, dates, links, and commitments against the sources. For an external audience, include only information intended for that audience and keep internal supporting material separate for your review.
116123

117-
Copy the reviewed draft into the app where you want to use it. Search creates text in your conversation; it doesn't send or publish the draft or change source records. See [use cases and example prompts](/search/use-cases) for more formats and tasks.
124+
Copy the reviewed draft into the app where you want to use it. Search creates text in your conversation; it doesn't send or publish the draft or change source records.
118125

119126
## Start from a document
120127

@@ -126,7 +133,6 @@ Your conversations remain private to you. Copying a source link does not give so
126133

127134
## Related docs
128135

129-
- [Use cases and example prompts](/search/use-cases): Apply Search to everyday work.
130136
- [Find content](/search/find-content): Search directly, filter results, and reopen recent sources.
131137
- [Connect your account](/search/connect-your-account): Check source connections and recover access.
132138
- [Use Sim Search in Slack](/search/slack#use-sim-search-in-slack): Ask questions from Slack when your organization has enabled it.

‎apps/docs/content/docs/search/index.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ For example, ask “Why did the Atlas launch date change? Use the project docume
1919

2020
Search mode retrieves and reads information and drafts text in your conversation. It does not send the draft or change source records. You choose where to use the reviewed result.
2121

22-
Start with [Get started](/search/quickstart) or browse [use cases and example prompts](/search/use-cases). [Connect your account](/search/connect-your-account) if your source requires a personal connection. The source setup below is for organization admins.
22+
Start with [Get started](/search/quickstart), then explore [Ask questions](/search/ask-questions) for more examples. [Connect your account](/search/connect-your-account) if your source requires a personal connection. The source setup below is for organization admins.
2323

2424
When enabled by your organization, [Sim Search in Slack](/search/slack#use-sim-search-in-slack) and [Search MCP](/search/mcp) let you search from other tools using the same retrieval and access rules.
2525

‎apps/docs/content/docs/search/meta.json‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@
55
"quickstart",
66
"find-content",
77
"ask-questions",
8-
"use-cases",
98
"troubleshooting",
109
"---Connect sources---",
1110
"connect-your-account",

‎apps/docs/content/docs/search/quickstart.mdx‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,4 +57,8 @@ Include a topic, a scope, and a desired result:
5757

5858
> Summarize **Atlas launch decisions** from **the past two weeks** as **five bullets with sources and open questions**.
5959
60-
Replace the example names with your own projects and teams. For more ideas, see [Use cases and example prompts](/search/use-cases).
60+
For a more detailed request, reuse this pattern:
61+
62+
> Using **[sources or topic]**, help me **[task]** for **[audience]**. Focus on **[scope and dates]**. Return **[format and length]**. Cite the sources and flag anything they don't establish.
63+
64+
You don't need every element for a simple question. Replace the example names with your own projects and teams. See [Ask questions](/search/ask-questions) for examples of comparing documents, understanding decisions, and drafting from your sources.

‎apps/docs/content/docs/search/use-cases.mdx‎

Lines changed: 0 additions & 102 deletions
This file was deleted.

‎apps/sim/lib/mothership/generated/docs-manifest.ts‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -460,7 +460,6 @@ export const DOCS_MANIFEST: readonly string[] = [
460460
'search/quickstart.mdx',
461461
'search/slack.mdx',
462462
'search/troubleshooting.mdx',
463-
'search/use-cases.mdx',
464463
'search/zoom.mdx',
465464
'tables.mdx',
466465
'tables/using-in-workflows.mdx',

0 commit comments

Comments
 (0)