- Definition lists can't have newlines between the term and definition
- Asterisks should be preferred to single backticks for italicising
text, as the latter means "default role" which can be customized in
some environments.
- Some literals aren't formatted as such
Change-Id: I0554a4ba49fd4cc071bc7f129686a7697b9c0d35
Signed-off-by: Stephen Finucane <sfinucan@redhat.com>