To avoid duplication of input/output tags; it would be nice to have a bridge that coincides with existing documentation comment tools.
For example Scaladoc has @param, and @return.
Great suggestion! I am actively pushing to try to make small decisions like this to make it flow with one's current documentation format as much as possible. I will definitely add this to the to-do list.