We should document functions in Scala as done in java, specifying parameters and (when applicable, not here i know) return values.