From 3b3844d7cbce5719d855f64e9f6d04903963e596 Mon Sep 17 00:00:00 2001
From: Eric Teunis de Boone <ericteunis@deboone.nl>
Date: Thu, 10 Aug 2023 13:47:09 +0200
Subject: [PATCH] Update README

---
 README.md | 64 ++++++++++++-------------------------------------------
 1 file changed, 14 insertions(+), 50 deletions(-)

diff --git a/README.md b/README.md
index 135f883..14f8f2a 100644
--- a/README.md
+++ b/README.md
@@ -1,19 +1,25 @@
 # Lilydrum (pipeband-drumming notation)
 
-Somehow, the drums part in lilypond does not cover a notation with only right and left hands
-(also known as Swiss style drum notation).
-That is, right is above the line and left is below it.
-In the same manner as the bagpipe.ly file included with lilypond, flams and drags are defined as a shortcut.
+[Lilypond](http://lilypond.org) does not cover drum notation for pipebands out of the box.
+That is, right is above the line and left is below it. \
+In the same manner as the bagpipe.ly file included with Lilypond, this library allows to easily use this notation with opt-in elements.
+See the [cheatsheet](./cheatsheet.pdf) ([ly](./cheatsheet.ly), [pdf](./cheatsheet.pdf)) for a handful of definitions.
 
-There has been such a lilypond include file earlier, made by Simon Froger
-(which includes all of the above).
-This repository builds on work.
-The original file can still be found at [http://lsr.di.unimi.it/LSR/Snippet?id=970](http://lsr.di.unimi.it/LSR/Snippet?id=970).
+![preview of the score](./example.preview.png) \
+*(see [./example.ly](./example.ly) for fully annotated code and its [score](./example.pdf))*
+
+There has been such a Lilypond include file earlier, made by Simon Froger. This repository builds on his work.
+The ~~original~~ (updated) file can be found at [http://lsr.di.unimi.it/LSR/Snippet?id=970](http://lsr.di.unimi.it/LSR/Snippet?id=970).
 
 [His website (French) can be found here](https://simonfroger.wordpress.com/lilypond/caisse-claire-ecossaise/)
 
 This repository has also been converted into a [lyp](https://github.com/noteflakes/lyp) package: [lyp/lilydrum](https://github.com/lyp-packages/lilydrum).
 
+*shameless plug:* \
+An example of scores typeset with this library can be found in
+ [kastdeur/pipeband-music](https://github.com/kastdeur/pipeband-music)
+ or
+ [on my website (pdf)](https://deboone.nl/scores/pipeband).
 
 ## How to use
 Add the following line to include the definitions for use in your document:
@@ -53,48 +59,6 @@ To make a pipeband drumstaff (a `DrumStaff` with a few specific changes) you can
 *You do not need to use PipeBandDrumStaff to use the music definitions.*
 
 
-## Example piece
-*(see [./example.ly](./example.ly) for fully annotated code and its [score](./example.pdf))*
-
-![preview of the score](./example.preview.png)
-
-
-This was generated by the following code.
-
-```lilypond
-\include "lilydrum.ly"
-
-\header { title = "Standards 6/8" }
-\score {
-        \new PipeBandDrumStaff {
-            \drummode {
-                \time 6/8
-                \repeat volta 2 {
-					\partial 8 d8:32( |
-					g8.)[ g16 \drag d8]	d8.[ d16 \drag g8] |
-					g8.[ \drag d16 d8]	d8.[ d16 \drag g8] |
-
-					\tutti {
-						\flam d8. d16 g8	d4.:32( |
-						d8.) g16 d8	\flam g4
-					}
-
-					d8:32( |
-					g8.)[ g16 \drag d8]	d8.[ d16 \drag g8] |
-					g8.[ \drag d16 d8]	d8.[ d16 \drag g8] |
-
-
-					\tutti{
-						\flam d8. d16:64( d8)	\flam d8. d16 \flam g8 |
-						d8.:32( d16) \flam g8	\flam d4
-					}
-				}
-            }
-        }
-    }
-```
-
-
 ### Embellishments (Side Drum)
 Flams and Drags can be added using `\flam` and `\drag`.
 They can determine whether to be left or right by themselves for simple expressions.