You should be documenting most type info at least at the function/method signature and data structure definition level anyway. May as well do it in the most-use

You should be documenting most type info at least at the function/method signature and data structure definition level anyway. May as well do it in the most-useful format possible. This is what gets me about “even modern relatively-low-boilerplate type systems just slow me down” folks. That means you’re skipping documentation you ought to be doing.