Should we mention all this in Javadoc comment? Would be good have it so we won't forget.