Update of markdown files after review