diff --git a/README.md b/README.md
index 5e3fb66..f469cc0 100644
--- a/README.md
+++ b/README.md
@@ -1,18 +1,20 @@
+# openpower-host-ipmi-oem
+
 This .so file is designed to support the OpenPOWER's BIOS OEM commands.
 Documentation can be found by contacting the OpenPOWER mailing list @
-https://github.com/open-power/op-build
+<https://github.com/open-power/op-build>
 
 ## To Build
 
-```
 To build this package, do the following steps:
 
-    meson setup build
-    ninja -C build
-
-To clean the repository again run rm -rf build.
+```shell
+meson setup build
+ninja -C build
 ```
 
+To clean the repository again run `rm -rf build`.
+
 ## Supported Commands
 
 - Partial Add
@@ -25,8 +27,8 @@
 
 Netfun: 0x3a Command: 0x11
 
-This command will call to reset the BMC to its factory default. See [here][0]
-for the factory reset implementation details.
+This command will call to reset the BMC to its factory default. See the
+[`FactoryReset`][0] interface for the factory reset implementation details.
 
 This includes:
 
@@ -42,7 +44,7 @@
 successful.
 
 This command is not allowed when the IPMI restriction mode is set to
-'Whitelist'. See [here][1] for more information.
+'Whitelist'. See the [`RestrictedModes`][1] interrface for more information.
 
 [0]:
   https://github.com/openbmc/phosphor-dbus-interfaces/tree/master/xyz/openbmc_project/Common/FactoryReset#xyzopenbmc_projectsoftwarebmcupdater