docs: more markdown updates

Signed-off-by: David Scott <dave.scott@citrix.com>