I like the point "The function documentation is its contract". I experimented using JSDoc instead of TypeScript on a recent javascript project and have found it so enjoyable, partly for that reason.