clarification, formatting
another try (still leaning no)
documentation for lists