diff --git a/docs/examples/multiple_files/readme.md b/docs/examples/multiple_files/readme.md
index 6a9d764..77e9ad3 100644
--- a/docs/examples/multiple_files/readme.md
+++ b/docs/examples/multiple_files/readme.md
@@ -1,7 +1,10 @@
 ## multi-file configuration example
 
 This directory demonstrates how to split your configuration across multiple files.
-Note that we re-define the top-level `rules` element in two different files; this is by design.
+Note that we re-define the top-level `rules` element in two different files; this provides a way to organize
+your rules however you like.
 
 It also serves as a real-world example demonstrating many of the available features of the system.
-It is copied from the author's actual mappings for Star Citizen.
\ No newline at end of file
+It is copied from the author's actual mappings for Star Citizen, using dual Virpil Constellation Alpha joysticks,
+CH Products pedals, and a custom-built button panel. (see https://git.annabunches.net/anna/hardware-projects/src/branch/main/flight-panel-2021-11 for
+implementation details of the button panel)
\ No newline at end of file