Could you elaborate on what you feel should be explained with more clarity?
Reply on news.ycombinator.com