add some files and *fix* the markdown