Idea detail
gs_03_link_ideas
reqlan rq/marketing_and_media/tutorials.rq:443
block
Summary
Audience: users with at least one idea file from gs_02.
Outcome: use bracket references and a wikilink; peek definition and go-to-definition; understand ideas as a navigable graph.
Runtime: 6 min.
Demo: `reqlan-tutorials-demo/reqs/product.rq` open. Caret inside `welcome_flow`. File contains `product_name` one-liner and `welcome_flow` block only — no links yet, no `account_model`, no `.reqlan`.
Related: reference reference_brackets reference_wikilink idea
Attributes
| Key | Value |
|---|---|
| example | ```rq product_name reqlan tutorials demo welcome_flow { New users land on a welcome screen with one primary action: create an account. Success continues into onboarding_checklist. } onboarding_checklist { After account creation, show three optional setup steps. Prefer the welcome screen as the way back if they bail early. } ``` |
| script | SCR: Open `reqs/product.rq`. `welcome_flow` and `product_name` visible. Caret in the welcome_flow body. VO: Ideas earn power when they point at each other. Square brackets name a neighbour in the graph. SCR: Below the welcome prose, add a new block `onboarding_checklist` from the example. Inside `welcome_flow`, type `Success continues into onboarding_checklist.` VO: The bracket link creates an edge. The target idea can live in the same file or another — the syntax is the same. SCR: F12 or Ctrl/Cmd-click `onboarding_checklist` — jump to the new block. Then Peek Definition (Alt+F12) back to the call site. VO: Follow the link — you are navigating a graph, not scrolling a long document. Peek when you want context without losing your place. SCR: In `onboarding_checklist`, add the wikilink: `Prefer the welcome screen as the way back if they bail early.` VO: Double-bracket wikilinks let you show a readable label right in the prose. The alias is for reading; the target is still the idea name `welcome_flow`. SCR: Sticky note: "Are wikilinks a different graph?" Show both link forms resolving to the same idea in go-to-definition. VO: Same graph, two spellings. Brackets for a quick hop; wikilinks when you want a readable label in prose. SCR: Optional five seconds: Command Palette → Reqlan: Show Local Graph if discoverable; otherwise stay in editor. VO: Try this: add a third idea `account_model` — accounts need an email and display name — and link both `welcome_flow` and `onboarding_checklist` to it once each. SCR: End card → next: "Your first base". |
| slides | { id title transition fade background brand-dark kicker Get started · 03 heading Link ideas asset logo notes Ideas earn power when they point at each other. }, { id brackets transition none background brand-panel heading Square brackets name a neighbour code_lang rq code Success continues into onboarding_checklist. notes The target can live in the same file or another — the syntax is the same. }, { id navigate transition fade background brand-panel heading Go-to-definition and peek body F12 or Ctrl/Cmd-click to jump. Alt+F12 to peek without losing your place. notes Follow the link — you are navigating a graph, not scrolling a document. }, { id wikilink transition none background brand-panel heading Wikilinks with an alias code_lang rq code Prefer the welcome screen as the way back. notes The alias is for reading; the target is still the idea name. }, { id misconception transition fade background brand-contrast heading Same graph, two spellings body Brackets for a quick hop. Wikilinks when prose needs a readable label. notes Both resolve to the same idea — not a separate link system. }, { id optional-graph transition fade background brand-panel heading Optional local graph body Command Palette: Reqlan: Show Local Graph — if you want a picture. notes Stay in the editor if you prefer; the graph is optional on day one. }, { id try-this transition fade background brand-dark heading Try this body Add account_model and link welcome_flow and onboarding_checklist to it once each. fragments Next: Your first base notes A third idea gives you a small triangle to walk through. }, { id end transition fade background brand-dark heading A graph, not a scroll asset logo notes Next: mark the folder as a base. } |
Ancestor context
No ancestor chain recorded.
| Kind | Idea | Path | Snippet |
|---|---|---|---|
| None | |||
| Kind | Idea | Path | Snippet |
|---|---|---|---|
| ideaset_member | get_started_series | reqlan rq/marketing_and_media/tutorials.rq | — |
| ideaset_member | slide_decks | reqlan rq/marketing_and_media/tutorials.rq | — |
| Kind | Idea | Path | Snippet |
|---|---|---|---|
| references | idea | idea | |
| references | onboarding_checklist | onboarding_checklist | |
| references | reference | reference | |
| references | reference_brackets | reference_brackets | |
| references | reference_wikilink | reference_wikilink | |
| references | welcome_flow | the welcome screen |
Initialising graph…