oops, fix debug builds
first pass documentation