more markdown and example usage elaboration