scaladoc & refactor convert.* method