Update YAML documentation

deprecate the write: argument.