Next: Indentation
Up: Good Style
Previous: Commenting the FORTRAN Source Code

Clear and Understandable Output and Prompts

This is another area where ``programmer judgment'' is brought to bear. Prompts for user input should make it clear what values the user can enter and what the information is. ``Enter a real number'', isn't a very useful prompt because it doesn't give the user a clue as to the purpose of the number. ``Enter the temperature, in degrees kelvin'' makes the purpose of the number much clearer. The same is true for sending output to the user; just printing out a number can be confusing!

``OK, so it just said 8.34667...What the heck does that mean?'' Just remember to be clear and concise (don't be too wordy! This isn't a Presidential acceptance speech.) and you'll be OK.


Next: Indentation
Up: Good Style
Previous: Commenting the FORTRAN Source Code

Hamlet Project
hamlet@cs.utah.edu