Jeff, many thanks, are right on both items.
Concerning 1) I've updated most of the includelets to contain some comments.. These comments are included in {{available-includelets}} (scroll down on https://openacs.org/xowiki/xowiki) and these are included in the object browser (see https://openacs.org/xotcl/show-object?object=::xowiki::includelet::my-references). Some of the includelets are end-user-friendly, some are more useful for developers, some are just used for sub-classing.
Concerning 2) This looks like a bug to me. I've added an entry to the issue tracker
https://openacs.org/bugtracker/openacs/bug?bug_number=3426
all the best
