improve PUMS documentation