AUI-1065 Document aui-scheduler 

Hey @zenorocha, I've been working on this all day and night hahah but I'm falling asleep...I only have 16 TODOs left. I'm going to be in San Diego this weekend so I figured I would send you my progress so far. Feel free to leave feedback and I will glady update my branch ^_^