the comment should still be further up (before the li(st) snippet).

Sounds like a plan to me about the documentation.