I'm tired of this cop-out. If your thing is extremely easy to implement poorly, to the point where good implementations are a small minority, your thing sucks and is bad.

Additionally if you don't call-out the gotchas/pitfalls, then you're misleading the large chunk of engineers/managers who find a blog post and then blindly follow the best practice.