How to swap your children

Have you run into issues when trying to swap your children? Rest assured - you are not alone.
The Flex 2 docs boast about how much easier depth management is in ActionScript 3. However, they don’t seem to mention that swapChildren() and swapChildrenAt() are buggy.
I was going crazy trying to manage the depth of some UI [...]