added a note about the partition and offset fields