I think it's better to document the context/intention/business reasons and let the code speak for itself.