som doc improvements