more docs on knife and whirr