update canonicalize documentation