fix #1329 -- rewrite listings docs

[ci skip]

Signed-off-by: Chris “Kwpolska” Warrick <kwpolska@gmail.com>