document that modal show()/hide() return before animation finishes

Fixes part of #11117.
/cc @twbs/team for review