add docstrings, update zhi test so it expoects nose to be run from the root dir