barn-hdfs: Update BarnHdfsWritter documentation

  + Update comment style to be more inline with scala style guide
  + Change references to timestamp to be: earlier, later instead
    of larger/smaller.