I think Procida's thinking about examples also works pretty well for best practices and anti-patterns: > You can and probably should use examples everywhere. I

I think Procida's thinking about examples also works pretty well for best practices and anti-patterns: > You can and probably should use examples everywhere. I think that a well-crafted example can often illuminate something much better than a painstaking attempt to describe it fully and completely... Examples illustrate extremely effectively, whether they are illustrating how-to guides, explanation, or whatever. But examples on their own seem a bit deracinated. What are they examples of? Don’t they need context? Best practices and anti-patterns usually work best in the context of how-to guides or references IMO