scheduler: some docstrings and comments added