Posts

Photo by Suzy Hazelwood on Pexels. Are docs a good investment? One of the challenges every documentarian faces is justifying the investment in docs. Whether that investment is salary training and professional development expanded doc team tooling dev help for site development It can feel like we technical writers are always battling it out for the company’s money. And, often, the experience is that the money for conferences or books or a new team member goes to other teams instead. Teams that have a clearer line of sight from work to the bottom line of the company’s P&L statement. ...

Photo by Startup Stock Photos from Pexels. Technical writing can be an introvert’s dream. (I know, I am one!) That said, there are two communities that every tech writer needs to develop to thrive in our work. Network of co-workers and subject matter experts Other tech writers for support and professional development Why are these communities vital? And how does a tech writer go about developing them? ...

Photo by Brett Jordan at Pexels. What makes a good technical document? A good technical article, document, or topic has a few key points that make it stand out: It understands the user and has empathy for the situation that brought them here, now. Don’t miss this point. It’s key. A good technical article has to be inside the mind of the user that’s come to the article. ...

Photo by Ron Lach from Pexels. You can’t hang out with knowledge management platforms for long without realizing that their structure, or, should I say, “architecture,” gets dated. It cracks. It goes stale. Stale knowledge, a litany Knowledge stops functioning the way it did at the beginning. The roads go awry. There are turnabouts everywhere. Dead ends. So many dead ends. ...

Photo by Mat Brown from Pexels. So you’ve done the work and you are ready to convert your docs from one tool to another. I, too, have done this. Actually, I am on my third time through doing such a massive undertaking. This time, as a lone writer having to maintain docs in both the old platform and the new. ...