use consistent header markers in markdown
typos and generalization of logs