Every couple years a new technology appears promising self-documenting APIs (hypermedia, OpenAPI, GraphQL). But in practice, someone still needs to write text even if it’s in code. Moreover, it only provides API reference which usually is not enough: you need tutorials, introduction, etc.

In my talk, I will present the current state of documentation generation and show what can be done automatically and what can not. Also, I will share my thoughts on new APIs technologies (GraphQL, gRPC) and what they bring to the table.