adds a lengthy overview of intent
adds note about not installing from npmjs.org
adds index to docs