The buffer transform is a pretty confusing thing, so document it in order to avoid misleading people.