updates and fixing a dead link in md file