final markdown update