add package documentation

This text is mostly identical to the initial commentary in the Emacs Lisp file, converted to use various GitHub Flavored Markdown (GFM) features.