Improve documentation of syntax for promoted lists