fixes part of #11117: doc that modal show()/hide() return before animation finishes
Merge pull request #11534 from twbs/doc-async-modals

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