more list upgrade docs