diff --git a/README.md b/README.md
index 08f992b..5f98f37 100644
--- a/README.md
+++ b/README.md
@@ -67,7 +67,9 @@ func main() {
 }
 ```
 
-See more examples at [doc/apps/SAMPLES.md](doc/apps/SAMPLES.md)!
+### Samples
+
+See [doc/apps/SAMPLES.md](doc/apps/SAMPLES.md) for more examples.
 
 
 ## Contributions
diff --git a/devices/lirc/doc.go b/devices/lirc/doc.go
index 3f7f72d..88119ba 100644
--- a/devices/lirc/doc.go
+++ b/devices/lirc/doc.go
@@ -45,4 +45,10 @@
 //
 // Please see documentation of package periph/host/rpi for details on how to set
 // it up.
+//
+// Hardware
+//
+// A good device is the VS1838. Then you need device driver for hardware
+// accelerated signal decoding, that lircd will then leverage to decode the
+// keypresses.
 package lirc