fixing md readme and adding explanations