Built-in Service Documentation in Comments Section of the Service

Suggesting to put the service description in comments section of the service itself. This will not just save developers’ time but also give (them) the confidence in choosing a service in a better way.

agreed, at least a link to the documentation page for that service

Let see in 10.x if they can adjust this feature request: