I&#x27;m OK with the &quot;one word&quot; parameter &#x2F; return value names, in part, I guess, because I&#x27;m also a big proponent of a &quot;pro forma&quot; comment banner for every routine.  For simple things, the comment can be a one-liner (&quot;Return thing X&quot;), but otherwise, explain each param and the return value.<p>Now, if the internal variables require a &quot;data dictionary&quot; level set of comments, that&#x27;s another matter.  Something is (usually) wrong in that case.