diff --git a/README.md b/README.md
index c282b2a..2c8077c 100644
--- a/README.md
+++ b/README.md
@@ -91,10 +91,10 @@
 and property, which you can overload to create your own customized behavior
 for the interface.
 
-There are currently two types of YAML files: [interface](docs/interface.md) and
-[error](docs/error.md). Interfaces are used to create server and client D-Bus
-interfaces. Errors are used to define C++ exceptions which can be thrown and
-will automatically turn into D-Bus error responses.
+There are currently two types of YAML files: [interface](docs/yaml/interface.md)
+and [error](docs/yaml/error.md). Interfaces are used to create server and client
+D-Bus interfaces. Errors are used to define C++ exceptions which can be thrown
+and will automatically turn into D-Bus error responses.
 
 [[D-Bus client bindings are not yet implemented.  See openbmc/openbmc#851.]]
 
diff --git a/docs/error.md b/docs/yaml/error.md
similarity index 100%
rename from docs/error.md
rename to docs/yaml/error.md
diff --git a/docs/interface.md b/docs/yaml/interface.md
similarity index 100%
rename from docs/interface.md
rename to docs/yaml/interface.md