> It could even be a relatively fake example and I think it would still land if your audience has had experience exploring large codebases The problem is this

> It could even be a relatively fake example and I think it would still land if your audience has had experience exploring large codebases The problem is this can get pervaded quickly. In most extreme cases, the 'example' is literally only useful for hello-world style things, and anything more complex requires digging deep into docs to understand (I can think of at least one .NET library where this 'blogger-friendly' API structure exists...) And then as alluded to, every example shows this simple case that doesn't help anyone know how to configure things in ways that are testable/etc.