Added isDestroying/isDestroyed flags meaning and invariants docs.
Merge pull request #2217 from opichals/docs-isdestroying-isdestroyed

Added isDestroying/isDestroyed flags meaning and invariants docs.