Generated docs are often crap. I'm not saying therefore don't generate, but I've seen plenty of generated docs that are difficult to read, and difficult to navi

Generated docs are often crap. I'm not saying therefore don't generate, but I've seen plenty of generated docs that are difficult to read, and difficult to navigate I find Google's chrome extension docs to be atrocious. Bad formatting making them almost unreadable (FOR ME!) and not enough examples.