Better documentation of the build.scala file

This ties nicely with [http://blog.eigengo.com/blog_posts/building-and-publishing](http://blog.eigengo.com/blog_posts/building-and-publishing) post.