updated docs

reflect status of overall debugging