That’s exactly my frustration. The DX: I’m refactoring my code, making some function private because they ought to be, and now I have a bunch of warnings to go fix.
The second point is what really gets me - I pretty much just care about getting better info about the private function’s contract ‘on LSP hover’ myself. My mind is a single-core processor with a small cache - I can’t juggle a lot of context in my head and jumping back and forth to read comments is effectively that.
If that requires a new nomenclature besides documentation and code comments, I’m fine with that.