From 6179ed50c00c3966dc95d1e25787f39e667d9197 Mon Sep 17 00:00:00 2001
From: Lars-Dominik Braun <lars@6xq.net>
Date: Mon, 2 Apr 2018 11:08:48 +0200
Subject: Add a proper example

---
 src/Codec/Pesto.lhs | 39 ++++++++++++++++++++++++++-------------
 1 file changed, 26 insertions(+), 13 deletions(-)

diff --git a/src/Codec/Pesto.lhs b/src/Codec/Pesto.lhs
index aa42d62..098f9cb 100644
--- a/src/Codec/Pesto.lhs
+++ b/src/Codec/Pesto.lhs
@@ -238,15 +238,35 @@ books.
 Introduction by example
 -----------------------
 
-So let’s start by introducing Pesto in a XXXnon-formal, XXX way: By example. We
-are now going to cook XXX. The following recipe contains all the information
-you need to do that.
+.. code::
 
-.. class:: todo
+	So let’s start by introducing Pesto by example. This text does not belong
+	to the recipe and is ignored by any software. The following line starts the
+	recipe:
 
-do it.
+	%pesto
 
-See https://github.com/PromyLOPh/rezepte for example recipes.
+	&pot
+	+1 l water
+	+salt
+	[boil]
+
+	+100 g penne
+	&10 min
+	[cook]
+
+	>1 serving pasta
+	(language: en)
+
+And that’s how you make pasta: Boil one liter of water in a pot with a little
+bit of salt. Then add 100 g penne, cook them for ten minutes and you get one
+serving pasta. That’s all.
+
+There’s more syntax available to express alternatives (either penne or
+tagliatelle), ranges (1–2 l water or approximately 1 liter water) and metadata.
+But now you can have a first peek at `my own recipe collection`_.
+
+.. _my own recipe collection: https://github.com/PromyLOPh/rezepte
 
 .. include:: Pesto/Parse.lhs
 .. include:: Pesto/Graph.lhs
@@ -264,10 +284,3 @@ three binaries.
 .. include:: ../Test.lhs
 .. include:: ../Doc.lhs
 
-Final words
------------
-
-.. class:: todo
-
-Do we even need this?
-
-- 
cgit v1.2.3