fixed markdown errors in docs
tidy up of docs and available date formats