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


And your documentation says that the possible values are


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