markdown updated and class diagram