docs/services-api: revise
docs/services-api: revise

- Rewrite lead section to be more concise
- Move to snake case method names
- Consistently use the terms "services" and "service bots"

[skip ci]

GLolol/PyLink