okarm01/21/2023, 7:15 PM
on published APIs? Consider this following screenshot. Do you consider that an acceptable level of commentary in a flagship library? Most public Ktor APIs suffer from the
problem. It conveys no information whatsoever while not mentioning critical information. For example here the KDoc doesn't even mention that the
/** * Performs action. */ public fun performAction()
channel filters out
frames. I always thought that we were waiting for the 2.0 release before all the documentation gets fixed (no point documenting API that's due for a breaking change), but it's 2.2.2 already and documentation is still missing.