Sedulously eschew obfuscatory hyperverbosity and prolixity.
Here is one that is worthy of the "things not to do in ColdFusion" entries on the BlivitLog, I think.
In an application I'm working on, there is a piece of data supplied from a mainframe called ag2-sort-by-date. It's a single character long and can be supplied with either a 'Y' or an 'N'. So far, so good.
The problem arises when the logic behind the field is examined. If the value of the field is 'Y', then the items this field is referring to are sorted alphabetically, if the value is 'N', then the items are sorted by date.
So now, the question becomes: What do I do about it? This app round-trips to the mainframe, so the data has to get back there in the same shape or all sorts of nasty things happen.
- Use it as is. "We make bug hunting FUN!".
- Use it as is. Document it everywhere it pops up in the code and hope for the best.
- Flip the values at the first and last point of contact (on import and export). Might cause problems when talking to the mainframe group trying to debug.