From 623c552ff4e2eda9cc710063a7cc674aa49264f4 Mon Sep 17 00:00:00 2001
From: Simon Willison <swillison@gmail.com>
Date: Wed, 15 May 2019 21:57:26 -0700
Subject: [PATCH] 'Try Datasette without installing anything using Glitch'

Also new 'Play with a live demo' section, both at the top of the Getting
Started documentation page.

https://datasette.readthedocs.io/en/latest/getting_started.html

Closes #464
---
 docs/getting_started.rst | 38 ++++++++++++++++++++++++++++++++++++--
 docs/installation.rst    |  3 +++
 2 files changed, 39 insertions(+), 2 deletions(-)

diff --git a/docs/getting_started.rst b/docs/getting_started.rst
index f4186531..3e205ca5 100644
--- a/docs/getting_started.rst
+++ b/docs/getting_started.rst
@@ -1,8 +1,42 @@
 Getting started
 ===============
 
-Basic usage
------------
+Play with a live demo
+---------------------
+
+The best way to experience Datasette for the first time is with a demo:
+
+* `fivethirtyeight.datasettes.com <https://fivethirtyeight.datasettes.com/fivethirtyeight>`__ shows Datasette running against over 400 datasets imported from the `FiveThirtyEight GitHub repository <https://github.com/fivethirtyeight/data>`__.
+* `sf-trees.datasettes.com <https://sf-trees.datasettes.com/trees/Street_Tree_List>`__ demonstrates the `datasette-cluster-map <https://github.com/simonw/datasette-cluster-map>`__ plugin running against 190,000 trees imported from `data.sfgov.org <https://data.sfgov.org/City-Infrastructure/Street-Tree-List/tkzw-k3nq>`__.
+
+.. _glitch:
+
+Try Datasette without installing anything using Glitch
+------------------------------------------------------
+
+`Glitch <https://glitch.com/>`__ is a free online tool for building web apps directly from your web browser. You can use Glitch to try out Datasette without needing to install any software on your own computer.
+
+Here's a demo project on Glitch which you can use as the basis for your own experiments:
+
+`glitch.com/~datasette-csvs <https://glitch.com/~datasette-csvs>`__
+
+Glitch allows you to "remix" any project to create your own copy and start editing it in your browser. You can also remix the ``datasette-csvs`` project by clicking this button:
+
+.. image:: https://cdn.glitch.com/2703baf2-b643-4da7-ab91-7ee2a2d00b5b%2Fremix-button.svg
+   :target: https://glitch.com/edit/#!/remix/datasette-csvs
+
+Find a CSV file and drag it onto the Glitch file explorer panel - ``datasette-csvs`` will automatically convert it to a SQLite database (using `csvs-to-sqlite <https://github.com/simonw/csvs-to-sqlite>`__) and allow you to start exploring it using Datasette.
+
+If your CSV file has a ``latitude`` and ``longitude`` column you can visualize it on a map by uncomminting the ``datasette-cluster-map`` line in the ``requirements.txt`` file using the Glitch file editor.
+
+Need some data? Try this `Public Art Data <https://data.seattle.gov/Community/Public-Art-Data/j7sn-tdzk>`__ for the city of Seattle - hit "Export" and select "CSV" to download it as a CSV file.
+
+For more on how this works, see `Running Datasette on Glitch <https://simonwillison.net/2019/Apr/23/datasette-glitch/>`__.
+
+Using Datasette on your own computer
+------------------------------------
+
+First, follow the :ref:`installation` instructions. Now you can run Datasette against a SQLite file on your computer using the following command:
 
 ::
 
diff --git a/docs/installation.rst b/docs/installation.rst
index de9c0a3d..8f41429d 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -3,6 +3,9 @@
 Installation
 ============
 
+.. note::
+    If you just want to try Datasette out you don't need to install anything: see :ref:`glitch`
+
 There are two main options for installing Datasette. You can install it directly
 on to your machine, or you can install it using Docker.