Thanks for your thoughts. While I certainly believe in self-documenting code where possible, I think there's a place for comments, and also for well structured

Thanks for your thoughts. While I certainly believe in self-documenting code where possible, I think there's a place for comments, and also for well structured comments. I wouldn't recommend going haywire and commenting on every HTML element, attribute, etc., any more than I'd recommend using any other language facility or tool like a sledgehammer. But that's not to say structured commenting isn't a useful tool for the right situations. I have found the JSDocs in the code-base of Angular and other libraries to be invaluable, on occasions where it wasn't possible to fully convey the meaning in pure code.