improved buffer documentation