add note about allocation