Agreed, it isn't something that novice pythonista's know. But if we have clear documentation then we can go with that.

I personally don't like all the list passing as args in the current mechanics module. It seems very clunky to me. That's why I recommend this method.