some documentation for scheduler