DOC: make the docs, userguide, and readme more newbie friendly