docs: add javadoc to scheduler methods and throw IllegalArgumentException when parameter is null#258