documenting parameters