update d/docs as appropriate