I'm seeing a lot of topics in Documentation like this one on the DOM. Because the DOM is not a particular function or code concept, it does not lend itself well to examples. Instead, the "Examples" section is being used like this to provide general information.
I know the obvious response is "Put it in Remarks instead!" but
- The Remarks section must be edited as a whole and can be changed on a whim
- Some topics really are purely informational and as such don't really have "Examples" or "Syntax", and to call this information simply "Remarks" belies the nature of the topic.
What is the solution here? Should Remarks be given multiple up- and down-votable entries like Examples to alleviate this? Should Remarks be renamed? Or is Examples really the place to put such information?
(Or...is StackOverflow Documentation not the place for such topics in the first place?)
DOM
, we would have examples of how to work with DOM in other language tags.