Alert notifications API documentation could use improvement?

I filed this issue: https://github.com/grafana/grafana/issues/15781. I’m just wondering if anyone else has found the API docs or parts of it needing improvement.