Idea detail
gs_02_first_idea
reqlan rq/marketing_and_media/tutorials.rq:327
block
Summary
Audience: freshly installed users who finished gs_01 or equivalent.
Outcome: create a `.rq` file; write a one-liner and a block idea; save; see syntax highlighting and language mode.
Runtime: 5 min.
Demo: folder `reqlan-tutorials-demo` open in VS Code. Extension installed; onboarding seen once. Explorer shows empty tree or `README.md` only — no `reqs/` folder yet, no `.reqlan`.
Related: idea simple_idea block_idea simplicity file
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. } ``` |
| script | SCR: Explorer in `reqlan-tutorials-demo`. Right-click → New Folder `reqs`. New File `reqs/product.rq`. Caret at line 1. VO: A reqlan file is just text with a `.rq` suffix. Start with the smallest form: a name, then the thought. SCR: Type keystroke-by-keystroke: `product_name reqlan tutorials demo`. Pause so token colours settle — name vs body. VO: That one line is already an idea. The name is a handle you will reference later. When you need more room, open a block. SCR: New line. Type the `welcome_flow` block from the example — open brace, body prose, close brace. Soft zoom on the body text inside braces. VO: Inside the braces, the first free text is the main description. No required metadata yet — just a name and the thought. SCR: Status bar: language mode shows reqlan (or Reqlan). Problems panel empty. Brief hover on bracket/brace highlighting if visible. VO: Save the file. If the extension is active, language support arrives immediately — highlighting, not a separate compile step. SCR: Chat bubble or sticky: "Do I need YAML front matter or a schema?" Cut back to the two-line file — no `@` attributes, no imports. VO: You do not. One-liners and blocks are valid on their own. Attributes and imports come later when you feel the need — not before your first idea exists. VO: Try this: rename `welcome_flow` to something that matches your own product, and rewrite the sentence in your voice. Save again. SCR: End card → next: "Link ideas". |
| slides | { id title transition fade background brand-dark kicker Get started · 02 heading Your first idea asset logo notes A reqlan file is just text with a .rq suffix. Start with a name, then the thought. }, { id new-file transition fade background brand-panel heading Create reqs/product.rq body New folder, new file, .rq suffix — that is the whole setup. notes No base marker yet. The extension works on plain text in an open folder. }, { id one-liner transition none background brand-panel heading Name, then thought code_lang rq code product_name reqlan tutorials demo notes That one line is already an idea. The name is a handle you will reference later. }, { id block transition fade background brand-panel heading Open a block when you need room code_lang rq code welcome_flow { New users land on a welcome screen with one primary action: create an account. } notes Inside the braces, the first free text is the main description. No required metadata yet. }, { id language transition fade background brand-panel heading Language mode and highlighting body Status bar: reqlan. Problems empty. Save to persist. notes Language support arrives immediately when the extension is active — not a separate compile step. }, { id misconception transition none background brand-contrast heading No schema required body One-liners and blocks are valid on their own. Attributes wait until you need them. notes You do not need YAML front matter or imports before your first idea exists. }, { id try-this transition fade background brand-dark heading Try this body Rename welcome_flow to match your product. Rewrite the sentence in your voice. fragments Next: Link ideas notes Save again so highlighting and index pick up the new name. }, { id end transition fade background brand-dark heading Two ideas, one file asset logo notes Next: connect ideas with references. } |
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 | block_idea | block_idea | |
| references | file | file | |
| references | idea | idea | |
| references | simple_idea | simple_idea | |
| references | simplicity | simplicity |
Initialising graph…