Who does this project actually serve? The "users", or someone else?
If I'm getting overwhelmed with hundreds of issues per week about some confusion around installation or use, I think those issues are completely justified. Something should probably be fixed if the happy path is this obscure. Pushing this reality into another bucket is not the solution for me.
It's one of those explanations that sound very plausible on paper, but if you see real world issues it just doesn't happen, users will ask questions that are clearly explained in the first paragraph of the readme, en masse.
Yeah but people justifiably don't exhaustively read documentation. If people are getting confused because they didn't read some bit of documentation - even the first paragraph of the readme - then you shouldn't just dismiss them as stupid and bask in your superior documentation-reading abilities. You should think about how to resolve that confusion in a way that they would actually see it.
It's hard to explain how to do that without a concrete example, but it usually is possible. It's also usually more work than just replying RTFM, but you should at least be aware that you are choosing not to bother.
I think a concrete example would help here. Let me find one from this repo...
Ok after looking through about 20 discussions I was actually unable to find a single one that was a misunderstanding or misconfiguration on the user's part. They appear to all be real bugs (or feature requests), and very high quality ones at that.
So I think their assertion that 80-90% of what people think are bugs are actually not is total and utter bullshit.
That's kind of unrelated to what we were discussing though; misunderstandings due to poor usability do happen but I guess we can't easily find examples in Ghostty.