updating markdown explanation