Updates on markdown documentation