I agree. We are always trying to improve this but it's a huge task as MDN is such a big site. If you could please file issues (or PRs :) when you find bad practice examples, it would help.