migrate from pod to md for readme
slightly more doco