1 files changed, 16 insertions, 1 deletions
diff --git a/README.md b/README.md
index dcdaf3a250..5370411ba7 100644
--- a/README.md
+++ b/README.md
@@ -62,6 +62,14 @@ code fragment.
 
 ### Macro replacements:
 
+- While MathJAX just support LaTeX style command definition, it is recommended
+  to not use this as it will likely cause issues with preparing the document
+  for PDF or ebook distribution.
+- `\SS` (which I could not find defined within the latex source) seems to be
+  closest to `\mathscr{S}`
+- `\TYPE` is equivalent to `\boldsymbol{type}'
+- As MathJAX has no support for slanted font (latex command \sl), so in all
+  instances this should be replaced with \mathit{}
 - The macro \U{ABCD} used for unicode character references can be
   replaced with \\uABCD.
 - The macro \URange{ABCD}{DCBA} used for unicode character ranges can be
@@ -92,4 +100,11 @@ syntax
 
     #. first entry
     #. ...
-    #. last entry
-\ No newline at end of file
+    #. last entry
+
+
+Finding rendering errors
+------------------------
+
+- MathJAX errors will appear within the rendered DOM as span elements with
+  class `mtext` and style attribute `color: red` applied.
+\ No newline at end of file