Documentation update -- Child workflows and poll API. (Issues 2063 & 2064)

I wasted a lot of time on figuring out that more than one event could transpire between decision tasks. I stumbled upon the solution in this repo and it helped me connect the dots and resolve my issue. Figured I'd update the documentation so other people don't run into the same issues.