Improvements to the lists docs