more changes and fix markdown