Improve API documentation coverage

[barjin]

In v3.17, the rendered API docs are often missing a plain-text description. This leads to rather ugly rendering on the API docs side ⬇️ and might add friction for new users or LLM agents.

Below are the coverage stats per package