This is more balanced view on how to structure your docs than previous article on this topic: https://news.ycombinator.com/item?id=26413937