Dumb vs. Smart Revision

Several readers of my posts on revision have pointed out that content gets revised for many reasons. Peter Fournier suggest a distinction should be made between dumb and smart revision. I’ll attempt to do that here.

An initial distinction between dumb revision and smart revision might be that smart revision adds value and dumb revision does not.

Trust is Essential to Creating Great Docs

My good friend Pamela Clark asks me to comment on

what product development organizations, processes, and structures best support great user-oriented documentation

I’ve commented over on Tom Johnson’s blog that tech pubs organizations tend to make a slow migration through the corporate landscape, and that I believe that the best home for pubs is in the development organization. But I also believe that tech pubs success is all about relationships, and there is more to that than simply the reporting relationship. In the end, if you want to create the conditions to do great work in tech pubs, you have to be valued. read more