diff --git a/doc/arm/_static/custom.css b/doc/arm/_static/custom.css
index e81d66d321..86f030fd3c 100644
--- a/doc/arm/_static/custom.css
+++ b/doc/arm/_static/custom.css
@@ -15,3 +15,11 @@ information regarding copyright ownership.
 .wy-table-responsive table td {
     white-space:normal;
 }
+
+/* readability improvements */
+.rst-content code.literal {
+    color: black;
+}
+.rst-content code.xref {
+    text-decoration: underline dotted gray;
+}