it seems like it might be helpful to you all to have some of this written up in the pants docs.