Add availability/deprecation information on API doc

[hacksparrow]

To address issues such as #779.

[hacksparrow]

@iamropo this one is for you.

[crandmck]

@hacksparrow is @iamropo going to address this, or should I put it in my queue?

[hacksparrow]

@crandmck sorry for such a late response. @iamropo will not be able to address it, in your queue please 🙏

[bjohansebas]

fixed by #2410