adding some IDE hints to batch and query set descriptors
expanding column documentation