add more comments around what paramters to join do