diff --git a/README.md b/README.md
index 3feea8a..62822e5 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,25 @@
 
 Arduino example code for working with pointlights
 
+## Pointlights.ino
+
+Demonstrating a state machine to create different behaviours
+
 For wiring of the LED see the [Arduino Fade tutorial](https://www.arduino.cc/en/tutorial/fade)
 
+## Sensor filtering
+
+Introduces how to work with an analog sensor and of to filter some of its output.
+
+For wiring of the LDR see [here](https://create.arduino.cc/projecthub/tarantula3/using-an-ldr-sensor-with-arduino-807b1c)
+
+## Sensor processing
+
+Introduces how to work with digital sensors, in this case a button, and how to process their input in a way which creates some degree of expressivity
+
+For wiring of button see [here](https://www.arduino.cc/en/Tutorial/BuiltInExamples/Button)
+
+## The combination of the three
+
+Is up to you :)