updated doctrings