still need documentation. we can rehash the doc argument now that @scopatz has joined us so that we can come to a final ruling. if you wish to do so, please put it on the dev list.