readme cleanup
dep bump
concise require api
readme updates
factory method and docs update