update doco a little bit - flesh it out