Toward that end, I've updated the Hive tutorial wiki https://cwiki.apache.org/confluence/display/Hive/Tutorial with the current timestamp semantics.
In the DDL section, we should call out the historical semantics and the former and current bugs. .. Owen