Add descriptions that help document your API. Docs are intended for readers of your API Definition as well as for populating your docs website.
Example of using docs
Let's say we want to add human-readable descriptions to a type, a service, and an endpoint. Docs can be used in Fern generators, including to populate your documentation website, OpenAPI description, or Postman collection.
docs: This is a movie object in IMDb (International Movie Database).
docs: This service helps grow the IMDb database.
docs: Use this endpoint to add movies to the database.