The Remarks section could be the right place for this sort of information. For instance, if you see several examples that do something dangerous with a language feature, it might be sensible to point out the pitfalls. Occasionally, there are language features that are only used by very new and very experienced users. (I'm thinking of things like goto and function-like macros.) It can be very helpful to warn people they are using powertools they might not have encountered before. (If there's just one hazardous example in a topic, it might be better to use an edit to add the note in the prose section of the example.)
In addition, if there's a safe alternative to a bad practice, be sure to add it as a competing example. That way, voting to can help readers avoid examples that might bite them down the road. Really bad examples will be voted down to the bottom of the page.
While constant bickering over coding styles is a potential problem, edits might be the best approach. Unlike Q&A, every edit must be approved by another user. Hopefully that will make edit wars less likely. (It will certainly make them inconvenient and slower moving.) Also unlike Q&A, editors gain reputation together from example upvotes. So if one editor adds a quick-and-dirty example and another cleans it up, both users benefit. Documentation, as designed, is more collaborative than Q&A.
One way to think of Documentation is the prescriptive/descriptive dichotomy. Some official documentation is purely descriptive in that it lists all features without having an opinion on when the feature should be used. Duplicating that effort would be a waste of time. On the other hand, purely prescriptive Documentation would presume there's some objective measure of good versus bad style. That's not the strength of Stack Overflow.
In an ideal world, the first example in a topic will be safe for anyone to use right out of the gate. But reading down page, it should be possible for people to find workarounds, overly-clever hacks, tricky-but-useful tricks, and perhaps even anti-patterns. The key is to give the reader the information either in the prose portion or in the Remarks to know which examples they should consider and which they should shun.