Clarify docs for some room state functions#16950

reivilibre merged 1 commit intodevelopelement-hq/synapse:developfrom

rav/state_funcs_docelement-hq/synapse:rav/state_funcs_docCopy head branch name to clipboard