Hmm I am not in favor of polluting the java docs with reasons for extending the JavaRDD interface -- From what I see this is a useful interface that any user code could use going forward. If required, I could add an inline comment inside the function I guess ?