add list upgrade docs