Can anyone point me to a nice resource that discusses - how to write good API documentation? I am trying to identify current shortcomings and it would be good to have a guiding light.

Check out https://idratherbewriting.com/learnapidoc/. It's aimed at technical writers, so you can skip some sections which introduces folks to technology being used.

yep, found this! Thanks 🙂