From 771db40d39a524ac797bc4424ac4b827750f590f Mon Sep 17 00:00:00 2001
From: Ricardo Lafuente <r@manufacturaindependente.org>
Date: Sun, 26 May 2024 23:20:59 +0100
Subject: [PATCH] Add chord reference table

---
 docs/patternlib/howtos/playchords.md | 63 ++++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)

diff --git a/docs/patternlib/howtos/playchords.md b/docs/patternlib/howtos/playchords.md
index ecad3c8a60..5d777d7095 100644
--- a/docs/patternlib/howtos/playchords.md
+++ b/docs/patternlib/howtos/playchords.md
@@ -17,6 +17,8 @@ Sus2 7sus2 sevenSus4 7sus4 nineSus4 ninesus4 9sus4 sevenFlat10 7f10 nineSharp5 9
 m7sharp5flat9 elevenSharp 11s m11sharp m11s
 ```
 
+See the chord reference below for a more comprehensive view.
+
 ## Playing with chords
 
 The list above can be combined with a root note using the `'` to use with the synths in Super Dirt like this:
@@ -68,3 +70,64 @@ This will give a pattern equivalent to:
 ```haskell
 d1 $ n "<[c'maj e'maj f'maj] [c'min e'min f'min]>" # s "supermandolin"
 ```
+
+## Chord reference
+
+This is a full list of the chords available in Tidal, along with the corresponding notes and alternative names.
+
+| Name       | Notes               | Alternatives     |
+| ---------- | ------------------- | ---------------- |
+| major      | `[0,4,7]`           | maj, M    |
+| aug      | `[0,4,8]`             | plus, sharp5  |
+| six      | `[0,4,7,9]`           | 6  |
+| sixNine      | `[0,4,7,9,14]`    | six9, sixby9, 6by9  |
+| major7      | `[0,4,7,11]`       | maj7    |
+| major9      | `[0,4,7,11,14]`    | maj9    |
+| add9 | `[0,4,7,14]` |   |
+| major11 | `[0,4,7,11,14,17]` | maj11  |
+| add11 | `[0,4,7,17]` |   |
+| major13 | `[0,4,7,11,14,21]` | maj13  |
+| add13 | `[0,4,7,21]` |   |
+| dom7 | `[0,4,7,10]` |  |
+| dom9 | `[0,4,7,14]` |  |
+| dom11 | `[0,4,7,17]`             |  |
+| dom13 | `[0,4,7,21]`             |  |
+| sevenFlat5 | `[0,4,6,10]`        | 7f5 |
+| sevenSharp5 | `[0,4,8,10]`       | 7s5 |
+| sevenFlat9 | `[0,4,7,10,13]`     | 7f9 |
+| nine | `[0,4,7,10,14]`           |  |
+| eleven | `[0,4,7,10,14,17]`      | 11 |
+| thirteen | `[0,4,7,10,14,17,21]` | 13 |
+| minor | `[0,3,7]` | min, m |
+| diminished | `[0,3,6]` | dim |
+| minorSharp5 | `[0,3,8]` | msharp5,mS5 |
+| minor6 | `[0,3,7,9]` | min6, m6 |
+| minorSixNine | `[0,3,9,7,14]` | minor69, min69, minSixNine, m69, mSixNine, m6by9 |
+| minor7flat5 | `[0,3,6,10]` | minor7f5, min7flat5, min7f5, m7flat5, m7f5 |
+| minor7 | `[0,3,7,10]` | min7, m7 |
+| minor7sharp5 | `[0,3,8,10]` | minor7s5, min7sharp5, min7s5, m7sharp5, m7s5 |
+| minor7flat9 | `[0,3,7,10,13]` | minor7f9, min7flat9, min7f9, m7flat9, m7f9  |
+| minor7sharp9 | `[0,3,7,10,14]` | minor7s9, min7sharp9, min7s9, m7sharp9, m7s9  |
+| diminished7 | `[0,3,6,9]` | dim7 |
+| minor9 | `[0,3,7,10,14]` | min9, m9 |
+| minor11 | `[0,3,7,10,14,17]` | min11, m11 |
+| minor13 | `[0,3,7,10,14,17,21]` | min13, m13 |
+| minorMajor7 | `[0,3,7,11]` | minMaj7, mmaj7 |
+| one | `[0]` | 1 |
+| five | `[0,7]` | 5 |
+| sus2 | `[0,2,7]` |  |
+| sus4 | `[0,5,7]` |  |
+| sevenSus2 | `[0,2,7,10]` | 7sus2 |
+| sevenSus4 | `[0,5,7,10]` | 7sus4 |
+| nineSus4 | `[0,5,7,10,14]` | ninesus4, 9sus4 |
+| sevenFlat10 | `[0,4,7,10,15]` | 7f10 |
+| nineSharp5 | `[0,1,13]` | 9sharp5, 9s5 |
+| minor9sharp5 | `[0,1,14]` | minor9s5, min9sharp5, min9s5, m9sharp5, m9s5 |
+| sevenSharp5flat9 | `[0,4,8,10,13]` | 7s5f9 |
+| minor7sharp5flat9 | `[0,3,8,10,13]` |  |
+| elevenSharp | `[0,4,7,10,14,18]` | 11s |
+| minor11sharp | `[0,3,7,10,14,18]` | m11sharp, m11s |
+
+
+
+