fix broken link

As using non-C locale can cause issues on upgrading OS.

Added database owner authentication with `sudo` when `su` does not work

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