fixed readme.md links, added code examples back in, updated sidebar formatting in docs