diff --git a/yaml/xyz/openbmc_project/Configuration/README.md b/yaml/xyz/openbmc_project/Configuration/README.md
index 0088c94..828c339 100644
--- a/yaml/xyz/openbmc_project/Configuration/README.md
+++ b/yaml/xyz/openbmc_project/Configuration/README.md
@@ -1,3 +1,5 @@
+# Configuration
+
 Interfaces under this subdirectory are written for compatibility with
 [entity-manager][entity-manager]. Entity-manager currently creates these style
 of objects from a JSON configuration, which doesn't support some of the type
diff --git a/yaml/xyz/openbmc_project/Logging/README.md b/yaml/xyz/openbmc_project/Logging/README.md
index 9f9c07f..78fdf1d 100644
--- a/yaml/xyz/openbmc_project/Logging/README.md
+++ b/yaml/xyz/openbmc_project/Logging/README.md
@@ -29,10 +29,10 @@
 - Every error defined will have an error YAML file and a corresponding error
   metadata YAML file.
 - The error YAML file contains the error name and a one-line description of the
-  error. An example of an error YAML file can be found [here][error-example].
+  error. An [example][error-example] of an error YAML file is available.
 - The error metadata YAML file captures required data. The format of the data is
-  defined in the error metadata file. An example of an error metadata YAML file
-  can be found [here][metadata-example].
+  defined in the error metadata file. An [example][metadata-example] of an error
+  metadata YAML file is available.
 
 [error-example]:
   https://github.com/openbmc/phosphor-dbus-interfaces/blob/master/yaml/xyz/openbmc_project/Common/File.errors.yaml