updates documentation
adds a few more markdown files