add notes in buckets and bucket types docs