Recent discussion on architecture documentation https://news.ycombinator.com/item?id=26048784