re-write markdown documentation