[tantalor]

Functions should be documented with the types of their parameters and return value.

[skylan_q]

I suppose I've just learned to really appreciate the "?" and "!" at the end of ruby function names...