Document BarnHdfsWriter

  + Add inline documentation (more annotation) to main barn-hdfs
    routine. This will hopefully inform the reader to the mechanics
    of synchronizing and shipping files.
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.
Merge branch 'master' into brapse-BarnHdfsWritter-inline-docs

Conflicts:
	barn-hdfs/src/main/scala/barn/main.scala
Merge pull request #17 from soundcloud/brapse-BarnHdfsWritter-inline-docs

Document BarnHdfsWriter