document s3 push and pull behavior