[l33t2328]

You shouldn’t have to read the code to understand what a program does, from an external POV at least.

[usrbinbash]

If the program comes with a specification then yes, ideally that should be the case.

If there isn't one however, then the code is all there is.