some more detail
adding notes, fixing markdown
new short-form description
resolve merge conflict
converting to markdown
removing vestigial rst
adding current shortforms