: Re: How can I express this more clearly or concisely? I'm documenting a block of computer code and would like to make it clear and concise. I'm describing a function that populates a field on

@Kevin153

Vote Up Vote Down

Given your comment to Monica, it seems to me that your original description goes way beyond what the function actually does. In particular, the function does not itself display the seller id, but instead returns it to some other code that displays it. The f_get_vend_code() function itself does not interact with either the form or the field, so there's no need to mention them.

If that's true, describe only what the function does: "This function returns the vendor code for the nut identified by NUT_ID."

Also: The name of the function and its parameter seem almost sufficient documentation in and of themselves. Could you improve those names so as to make the documentation unnecessary? At least spell out "vendor" instead of unnecessarily abbreviating it as "vend". If you do that, what's left for the documentation to convey?

(0)

Login to post a comment!