Hi, Here how I see it :
{{doclist /}} // displays all documents on the wiki with no restriction
{{doclist creator="XWiki.JohnDoe"/}} //displays all docs created by John Doe
{{doclist class="Blog.BlogPostClass" /}} displays all docs containing a Blog Post
{{doclist class="XWiki.SchedulerJobClass" space="Scheduler" /}} displays all docs containing a scheduler job in the Scheduler space
I think most of the metadata carried by XWikiDocument should be supported by the table (dates, author/creator, tags, etc.)
I will think a little about how columns parameters should be expressed, probably using the macro's content, with a default on standards columns.
How about: {{doclist ....}} |(%field="doc.name" sort="true"%)Name |(%field="doc.creator"%)Creator |(%field="doc.tags"%)Tags {{/doclist}} Looks familiar :) - Asiri