fleshed out markdown files