SPARK-2624 update documentation and comments