Signed-off-by: Ashwin S. Nair <58840757+Ashwin-exe@users.noreply.github.com>

Converting some of the rst documentation to markdown.  Attempted to
preserve whitespace and line breaks to minimize cosmetic change.