It would be interesting if this documentation was written directly into the code itself. For instance the default value is already right there. TypeScript adds the type information. If there was a way to add comments on each parameter name, so that the compiler didn't remove it, that would be neat. I mean inside the function itself.