[doc] suggest restriction to ASCII character set
diff --git a/doc/rm/hjson_usage_style.md b/doc/rm/hjson_usage_style.md
index 1bc4d87..9d69fe3 100644
--- a/doc/rm/hjson_usage_style.md
+++ b/doc/rm/hjson_usage_style.md
@@ -56,6 +56,11 @@
'''
```
+### Text Format
+
+Where possible, please restrict Hjson text to the ASCII character set to avoid downstream tool issues.
+Unicode may be used when referring to proper names.
+
### File delimiters and header
***Use `{}` to delimit the file***
@@ -100,7 +105,7 @@
The valid keys for each tool are described in the tool documentation.
The style is for a simple value to be in quotes (even if it is a number) and the tool should manage any type conversions.
-In some cases hjson allows the quotes to be omitted from values, but this is not recommended because the value string will not be terminated by a comma so there is potential for confusion when multiple key-value pairs are put on the same line.
+In some cases Hjson allows the quotes to be omitted from values, but this is not recommended because the value string will not be terminated by a comma so there is potential for confusion when multiple key-value pairs are put on the same line.
For example:
```hjson {.good}
diff --git a/doc/rm/markdown_usage_style.md b/doc/rm/markdown_usage_style.md
index f843c51..73732ef 100644
--- a/doc/rm/markdown_usage_style.md
+++ b/doc/rm/markdown_usage_style.md
@@ -150,7 +150,10 @@
An online editor for wavejson can be found on the [WaveDrom](https://wavedrom.com/) website.
The processor built in to `docgen` should produce the identical output, but has one extension that `cdata` may be used in place of `data` to allow labeling all bit positions not just the `2345` ones.
+### Text Format
+Where possible, please restrict markdown text to the ASCII character set to avoid downstream tool issues.
+Unicode may be used when referring to proper names.
### Comments
