created some documentation in markdown files