updated docs for n00b-friendlieness