doc: making changes to avoid bad syntaxical colorization interpretation