doc: updated the markdown doc.
minor coding style fixes.