While browsing the Internet looking for a hint on how to make
a thumbnail of a given image, I came across some code that
set some RenderingHints into a Graphics2D object before calling
the drawImage method. Wanting to understand what those hints
meant, I turned to the RenderingHints javadoc, only to be flusterated
and consternated and otherwise inconvenienced by the fact that the
descriptions doesn't give the reader any clue as to what they mean.

e.g. The documentation for RenderingHints.KEY_ALPHA_INTERPOLATION
says simply

   Alpha interpolation hint key

Well, hmm, that's what they call a "Circular Definition" in the
dictionary business. That is, all that's happening is you're
repeating the name of the constant, and not providing any definition
of what the actual semantics are. Any developer reading this is
going to come away confused.