fixed up docs for new descr api