merge_hook - improve code comments