Re: [whatwg/dom] Useless documentation (#1001)

This is because any web standard is written not for web developers who need to understand the technology, but for browser creators only. In other words, it does not educate step by step how to use things, but specifies instead how exactly these things must work and be built. That's why is has lots of mundane technical details and lots of clutter - just to make browsers ticking precisely.

For developer oriented tutorials that really untangle all of this stuff, there are third party sites really dedicated to it, like MDN (https://developer.mozilla.org/) and extremely vast step by step tutorials googlable by queries like `css tutorial`.

**However, I absolutely agree that in-specification examples "for web developers" can be used only to recall small details** and have no use for these who meet it in the first time and need context where specification bits may be used. In other words, the XXX specification requires already existing background and experience in XXX to correctly understand what happens in the specification.

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/whatwg/dom/issues/1001#issuecomment-877668759