updated allocating_memory documentation