<rant>

If you are going to document your software/middle-ware/project… hell anything, it does no good to document values without telling us what those values are!!

For example, if you have a java configuration file, and the property is something like

system.important.function

And your documentation says that the possible values are

foo|bar|nuts

Without telling us the behavior differences of each value, you’ve screwed up. Documentation is not self documenting damnit!

</rant>