Properly document the new unified API lister

Now that new listers have been properly ported to their new api. This needs some proper documentation work.

---

Migrated from T3073 (view on Phabricator)