Update API docs

[grnd-alt]

API Docs are quite outdated and sometimes have false information. We should update these docs so users don't have to reverse engineer (and be suprised by api changes with not updated docs)

As examples where this happened:
#6830
#7681
#3127

[vdiezel]

Hey!

I had made a PR #7158 that updated quite a bunch last year. The PR is approved, but even if you decide against merging it, you might find interesting bits there.