diff --git a/README.md b/README.md
index b689143..eef1bee 100644
--- a/README.md
+++ b/README.md
@@ -44,4 +44,11 @@ Note.fromString("A4").transpose(interval).toString(); // A5
 const majorScaleFormula = ["P1", "M2", "M3", "P4", "P5", "M6", "M7"];
 const scale = new Scale("A", majorScaleFormula);
 scale.getNotes().map((note) => note.toString()); // ["A4", "B4", "C#5", "D5", "E5", "F#5", G#5",]
+const ionian = new Scale("C", "ionian");
+ionian.getNotes().map((note) => note.toString()); // ["C4", "D4", "E4", "F4", "G4", "A4", "B4", ]
+ionian.getScaleInfo(); // { name: "Major", formula: "<...>", altNames: ["Bilaval theta", "Ethiopian (A raray)", "Ionian", "Mela Dhirasankarabharana (29)", ]}
 ```
+
+### Chords
+
+Coming soon ...