fix text linking

Author: thomasp85

doc/_quarto.yml

@@ -65,50 +65,57 @@ website:
           - text: Report a Bug
             href: https://github.com/ggsql-dev/ggsql/issues
   sidebar:
-    id: syntax
-    title: Syntax
-    style: "floating"
-    search: true
-    logo: false
-    contents:
-      - text: Overview
-        href: syntax/index.qmd
-      - section: "Main clauses"
-        contents:
-          - text: "`VISUALISE`"
-            href: syntax/clause/visualise.qmd
-          - text: "`DRAW`"
-            href: syntax/clause/draw.qmd
-          - text: "`PLACE`"
-            href: syntax/clause/place.qmd
-          - text: "`SCALE`"
-            href: syntax/clause/scale.qmd
-          - text: "`FACET`"
-            href: syntax/clause/facet.qmd
-          - text: "`PROJECT`"
-            href: syntax/clause/project.qmd
-          - text: "`LABEL`"
-            href: syntax/clause/label.qmd
-      - section: Layers
-        contents:
-          - section: Types
-            contents:
-              - auto: syntax/layer/type/*
-          - section: Position adjustment
-            contents:
-              - auto: syntax/layer/position/*
-      - section: Scales
-        contents:
-          - section: Types
-            contents:
-              - auto: syntax/scale/type/*
-          - section: Aesthetics
-            contents:
-              - auto: syntax/scale/aesthetic/*
-      - section: Coordinate systems
-        contents:
-          - auto: syntax/coord/*
-
+    - id: syntax
+      title: Syntax
+      style: "floating"
+      search: true
+      logo: false
+      contents:
+        - text: Overview
+          href: syntax/index.qmd
+        - section: "Main clauses"
+          contents:
+            - text: "`VISUALISE`"
+              href: syntax/clause/visualise.qmd
+            - text: "`DRAW`"
+              href: syntax/clause/draw.qmd
+            - text: "`PLACE`"
+              href: syntax/clause/place.qmd
+            - text: "`SCALE`"
+              href: syntax/clause/scale.qmd
+            - text: "`FACET`"
+              href: syntax/clause/facet.qmd
+            - text: "`PROJECT`"
+              href: syntax/clause/project.qmd
+            - text: "`LABEL`"
+              href: syntax/clause/label.qmd
+        - section: Layers
+          contents:
+            - section: Types
+              contents:
+                - auto: syntax/layer/type/*
+            - section: Position adjustment
+              contents:
+                - auto: syntax/layer/position/*
+        - section: Scales
+          contents:
+            - section: Types
+              contents:
+                - auto: syntax/scale/type/*
+            - section: Aesthetics
+              contents:
+                - auto: syntax/scale/aesthetic/*
+        - section: Coordinate systems
+          contents:
+            - auto: syntax/coord/*
+    - id: get_started
+      title: Get started
+      style: "floating"
+      search: false
+      logo: false
+      contents:
+        - text: Installation
+          href: get_started/installation.qmd
 
 format:
   html:

doc/get_started.qmd

@@ -0,0 +1,3 @@
+sidebar: get_started
+page-navigation: false
+toc: false

doc/get_started/_metadata.yml

@@ -0,0 +1,21 @@
+---
+title: "Your first plot"
+---
+
+Before you spend time on the minutia of installing ggsql — not that it is particularly daunting — why not try it out right now, right here, in your browser?
+
+The code below shows a simple ggsql example. But it is not just a static piece of text and an image. It is ggsql running right in your browser, using one of the built-in datasets. Try to change e.g. the title and see the plot update as you type. Even though this may be your first encounter with the ggsql syntax you might already get a sense of how some of the things fit together. See if you can change the code to instead show the different species as different shapes
+
+```{ggsql}
+VISUALISE bill_len AS x, bill_dep AS y, species AS fill FROM ggsql:penguins
+DRAW point
+SCALE x RENAMING * => '{} mm'
+LABEL
+   title => 'Relationship between bill dimensions in 3 species of penguins',
+   x => 'Bill length',
+   y => 'Bill depth'
+```
+
+Congratulations! You have started your journey with ggsql! All examples you see on this site will be interactive. Please experiment to your heart's content. If you want a more dedicated exploration experience head to [our playground](wasm/) which provides a simple IDE with a number of examples to try out.
+
+Now that you have gotten a feel for ggsql you may want to try running locally with your own data. Read on to learn how.

doc/get_started/first_plot.qmd

@@ -0,0 +1,24 @@
+---
+title: The grammar of graphics
+---
+
+ggsql is a tool for visualising data, combining our 20 years of experience developing [ggplot2](https://ggplot2.tidyverse.org/) with a SQL-native syntax.
+Unlike most visualisation systems, ggsql has an underlying grammar, based on the [Grammar of Graphics](https://en.wikipedia.org/wiki/Wilkinson%27s_Grammar_of_Graphics) by Leland Wilkinson.
+This is a different approach than the one taken by most tools, which give you a set of pre-defined graphics, like scatterplots, bar charts, and pie charts.
+ggsql instead gives you a number of independent components that you can combine to solve a very wide set of problems.
+
+This means there's a learning curve to ggsql: you have to learn a few big ideas about the grammar before you can be productive.
+But we believe the payoff is worth it.
+The grammar gives you new vocabulary and new ways to think about visualizations.
+This allows you to create not only familiar graphics but also newer, better graphics.
+You'll gain the ability to look at a visualization that someone else has made, analyse the key components, then recreate it yourself.
+The hardest part of learning ggsql is likely to be unlearning the preconceptions that you bring over from previous visualization tools.
+
+We've tried to make the learning curve as easy as possible by keeping the grammar close to the SQL syntax that you're already familiar with.
+You'll start with a classic `SELECT` statement to get the data that you want.
+Then you'll use `VISUALIZE` (or `VISUALISE` 🇬🇧) to switch from creating a table of data to creating a plot of that data.
+Then you'll `DRAW` a layer that maps columns in your data to aesthetics (visual properties), like position, colour, and shape.
+Then you tweak the `SCALE`s, the mappings between the data and the visual properties, to make the plot easier to read.
+Then you `FACET` the plot to show how the relationships differ across subsets of the data.
+Finally you finish up by adding `LABEL`s to explain your plot to others.
+This allows you to produce graphics using the same structured thinking that you already use to design a SQL query.