Since its advent, DevOps has been pitted against IT service management (ITSM) and its ITIL framework. Some say “ITIL is under siege,” some ask you to choose sides, while others frame them as complementary. What is true is that both DevOps and ITSM have fans and detractors, and each method can influence software delivery and… Continue reading How to solve the DevOps vs. ITSM culture clash | Opensource.com
It’s common for enterprises to leave the technical writer’s role out of the DevOps discussion. Even the marketing department joins the discussion in some DevOps-first organizations—so why not the writers? Source: Hiring a technical writer in the age of DevOps | Opensource.com
There’s a law of diminishing returns you have to watch out for when you’re developing thought leadership and other content. “Perfect is the enemy of good,” according to Voltaire. It’s possible to work on content for too long. For example, creating a PowerPoint deck that takes for months. Or, the fact sheets and white papers… Continue reading The law of diminishing returns and content development
I wrote a post entitled Confessions of a dyslexic technical writer about how I use my dyslexia as an advantage as a writer. The post still draws some feedback from other adult dyslexics. Here are some other confessions I’d add to the post if I wrote it today:
I work in an industry that’s hungry to have their VPs, directors, and senior technical staff to become thought leaders. Informed opinion leaders and the go-to people in their field of expertise. They are trusted sources who move and inspire people with innovative ideas; turn ideas into reality and know and show how to replicate… Continue reading Is there a thought leadership double standard for writers?
I took an interest in editorial reviews early in my career. That interest drove me to become a technical reviewer in the computer book industry for several years. I’m not sure they even have that role anymore. At the least publishers may not pay for that review anymore. Sitting through curt and incomplete document reviews… Continue reading In defense of kindness in the editorial review cycle
Too many technical writers live in style guides, single sourcing, FrameMaker, processes, and methodologies. They can sometimes escape from the business of software development. This monk like college advanced composition teacher existence can separate the technical writer from the realities of today’s dysfunctional workplace.When facing down ambiguity, technical writers have two choices: Wallow in the… Continue reading Ambiguity should signal ownership for technical writers