diff --git a/website/src/content/docs/getting-started/modes.mdx b/website/src/content/docs/getting-started/modes.mdx index c86ab1a..a54710b 100644 --- a/website/src/content/docs/getting-started/modes.mdx +++ b/website/src/content/docs/getting-started/modes.mdx @@ -58,7 +58,30 @@ That runs just this one line as SQL; you stay in simple mode afterwards. ## Seeing the SQL behind a command -When you run a simple-mode command in advanced mode, the playground prints -the equivalent SQL beneath your command. It is a built-in way to learn how -the friendly commands map onto real SQL — the same statements you could type -yourself in advanced mode. +Run a **simple-mode command while in advanced mode** and the playground prints +the equivalent SQL beneath it, tagged `Executing SQL:`. This is one of the most +useful ways the playground teaches: you write the friendly, readable command, +and immediately see the real SQL statement it stands for — the same statement +you could have typed yourself. + +It turns every command into a small SQL lesson. Add a column the easy way and +watch the `ALTER TABLE` it maps to: + +```rdbms +add column to books: title (text) +``` + +``` +Executing SQL: ALTER TABLE books ADD COLUMN title text +``` + +The payoff grows with the command. A single `create m:n relationship` — the +one-line way to +[link two tables many-to-many](/reference/relationships/#many-to-many-relationships) +— expands to an entire junction table: two foreign-key columns, a compound +primary key, and two cascading foreign keys, all spelled out in the echo. + + + +Because the echo is exactly what runs, it doubles as a recipe: read it, copy +it, tweak it, and run your own version in advanced mode. diff --git a/website/src/content/docs/using-the-playground/getting-help.md b/website/src/content/docs/using-the-playground/getting-help.md index e2b01b3..d9303da 100644 --- a/website/src/content/docs/using-the-playground/getting-help.md +++ b/website/src/content/docs/using-the-playground/getting-help.md @@ -25,9 +25,3 @@ Shows the type reference on its own. Outside the app, run `rdbms-playground --help` for the [command-line options](/using-the-playground/command-line-options/). - -:::note[Planned] -A `hint` command for contextual help on the current input or the last error -is planned and not yet available — but the input already shows hints as you -type (see [The assistive editor](/using-the-playground/the-assistive-editor/)). -::: diff --git a/website/src/content/docs/using-the-playground/the-output-pane.mdx b/website/src/content/docs/using-the-playground/the-output-pane.mdx index ab87077..ba0b23f 100644 --- a/website/src/content/docs/using-the-playground/the-output-pane.mdx +++ b/website/src/content/docs/using-the-playground/the-output-pane.mdx @@ -36,6 +36,5 @@ show more detail and is marked with a coloured border; :::note[Planned] A fuller session journal — a scrollable, richly rendered log of the whole -session that you can save as Markdown — and multiple result tabs are planned -and not yet available. +session that you can save as Markdown — is planned and not yet available. :::