Adding documentation related to orchestartion

Mainly b/c I am having trouble remembering how it
works as it gets more complicated.