document constructor args better