> What point are you trying to make? That maybe our time is better spent by taking the chance to simplify the languages of the web along use cases rather than

> What point are you trying to make? That maybe our time is better spent by taking the chance to simplify the languages of the web along use cases rather than document the whole of it in an encyclopedia. The Java example is a good one, since IME tools such as javadoc, and just writing down the purpose of something and why and when it was introduced, immensely helps cleaning up your API surface. The web as it is is way too complicated when it really doesn't have to be, as witnessed by browsers vanishing.