updated markdown documentation (reference)