(#10163) Cleanup some of the inline documentation and README file to align with gener...

(#10163) Cleanup some of the inline documentation and README file to align with general forge usage.

* The README.markdown file had a lot of property information that was
  duplicated in the type itself. The README.markdown file has more info in
  some cases, I have moved this into the type.
* The README.markdown lacked documentation on how to install the module using
  the forge which meant users accessing it via github would be inclined to
  download the development version from github instead.
* Cleaned up doc string alignments and made it consistent with all types.