We are not in disagreement here. I was making a comparison in kind as a cheap rhetoric trick. Documentation is good, no documentation bad, good documentation can be better.
Slide along the scale towards more and better documentation and our perceptions might diverge. I don't think all the valuable know-how that goes in to fulfilling a specific role in a larger organization (and in particular the marginal knowledge, relations and skill that increases performance) can be captured in words. Even if it were, there is so much of it and it is full of subtle nuance and context sensitivity. On top of that each individual person takes to different parts of it in different ways. The things you can only learn by jumping in at the deep end. We all know, deep inside, that this is the stuff that matters and I see no reason to play charades and pretend we can know or see how even half of what we do really works. If we did, the world would be a very different place. Until then: tacit, implicit, context bound and relation contingent knowledge and skill will be the light that shines on our practice; and what we can put in to words, a mere shadow.
Slide along the scale towards more and better documentation and our perceptions might diverge. I don't think all the valuable know-how that goes in to fulfilling a specific role in a larger organization (and in particular the marginal knowledge, relations and skill that increases performance) can be captured in words. Even if it were, there is so much of it and it is full of subtle nuance and context sensitivity. On top of that each individual person takes to different parts of it in different ways. The things you can only learn by jumping in at the deep end. We all know, deep inside, that this is the stuff that matters and I see no reason to play charades and pretend we can know or see how even half of what we do really works. If we did, the world would be a very different place. Until then: tacit, implicit, context bound and relation contingent knowledge and skill will be the light that shines on our practice; and what we can put in to words, a mere shadow.