I coined the term management overhead when I was working in a highly politicized environment. VP level management became obstructions to productivity. In some cases, I was on project teams where VPs and directors outnumbered the people who could do the work. Here’s what I like to call the 5 deadly sins of management overhead:
Continue reading “The 5 deadly sins of management overhead”
So it’s midway through week 2 and the fun continues. I came to peace years ago that I have a very solitary job as a technical writer. Even when working on teams, I work as an individual contributor. I’ve even had long term writing clients to whom I’ve never spoken with over the phone much less face-to-face.
Here are some ways I’m amusing myself:
I spoke to a friend yesterday on the phone who was pick up a laptop for his wife so she could work from home. He told me that the store he was running out of laptops. These are the times we live in!
How is your Wednesday going?
I follow enterprise collaboration both as a long time technical writer in the IT industry and as somebody who has written about collaboration platforms over the years for online publications.
It can be too easy to wreck collaboration in my mind. I’ve seen it many times happen during my career, giving me strong beliefs about collaborative cultures and technologies.
I’ve worked with people in the past who thought that collaboration was a coworker doing something for them. These people had a lot of dependencies on other team members. The team never seemed to depend on these sorts of people much.
It’s not to say you shouldn’t help your coworker. Working with this type of person made me remember my best collaborations. The common theme in those collaborations was a complementary exchange back and forth of information, input, and insights that benefited the project, team, and the collaborators themselves.
It’s not to say that non-technical people are at a disadvantage with collaboration inside technology organizations. They need to pony up from their own unique strengths.
In the past, I’ve said that collaboration can be transactional depending on the organizational culture. Take, for example, the time-strapped organization that’s not well organized. It’s easier to get help from somebody in such cultures if you can help them towards their project goals.
I’ve come across awful excuses for collaboration platforms and processes during my years as a technical writer. Sometimes, these collaboration tools were downright business prevention. Users kept using email for collaboration or resorted to sundry acts of Shadow IT to collaborate on files.
Microsoft SharePoint is a prime example where users sometimes have to work for the tool. Think of the times you’ve encountered sluggish performance, Draconian security policies, and poor user experience (UX) that added up to you and your team working around SharePoint to get your job done. No team should have to lose time due to SharePoint issues. For example, I can remember having to use my personal OneDrive account on a contract because of my client couldn’t get access to their SharePoint site for me as a contractor. There were other cases where I had to use my personal Dropbox to collaborate on files.
Looking at some of my best collaborations past and present, I see a comfort zone between coworkers and teams as integral to collaboration success. There needs to be a level of trust and respect amongst team members to make collaboration efforts fruitful.
Working a technical writer — an individual contributor at that — I have to find a comfort zone between me and the subject matter expert (SME) to get the information I need to write. Most often, this means writing a document draft using as many source materials as I can find. I then go to them to the SME to review the draft and patch any gaps.
For my article writing, it means having positive relationships with editors and PR people whom I’ve never met face-to-face or even over video chat. Such trust and a comfort zone come from responding to requests, clear and concise communications, and doing right by the article amongst other factors.
I’ve written in the past about collaboration being about culture before technology. My recent writing about DevOps continues to drive home that point for me.
Full confession, I’m a total collaboration tool geek about SharePoint, Atlassian Confluence, Microsoft Teams, and other tools. Collaboration is a topic I miss writing about, yet I’m the first to admit that none of these technologies can fix a culture that isn’t collaborative.
I often find that enterprises neglect that everybody needs to be an owner in collaborative environments. At a top-level, it means decentralizing the control of your internal collaboration sites to project teams. Major collaboration platforms have the rights settings that can enable you to open up privileges to users without harming overall compliance.
Managing collaboration platforms needs to become part of the team DNA and made easy so it works in the background. For example, a technical writer has a big role to play in SharePoint environments. They should know their document library. They can play that role at the team level. Business analysts can and should play a similar role. Project managers should be able to speak to their schedules and related project artifacts.
The technologies and culture that power collaboration still fascinates me to this day. I’ve seen so many enterprise collaboration initiatives tank over my career. The initiatives I saw become successful were most often grassroots happening at the project team level.
My name is Will Kelly. I’m a technical writer and content strategist based in the Washington, DC area. I’ve written for corporations and technology publications about such topics as cloud computing, DevOps, and enterprise mobility. Follow me on Twitter: @willkelly
I’m a big fan of Atlassian Trello for managing editorial projects so I was happy to find that Trello integration is now available for Microsoft Teams. These two applications are an ideal match — both popular with end users — plus making Trello available from inside Teams is another way to enable project teams to use the applications that make them productive.’
Go to the Microsoft Teams Store. Click on Trello. A descriptive dialog appears that’ll guide you through integrating Trello into Microsoft Teams.
Select a Team in which to add Trello. For purposes of this post, I chose a Team named Testing.
Click Install. Now Trello is available for the Team you specified in the installation. Next, specify a channel for Trello.
Click Set up beside each feature you want to set up. During the writing of this post, I set up all the features.
Click Log in with Trello. The Trello Login appears. Select a Trello board for collaboration. Click Save. The Trello board you select appears as a tab available to the Team
Once you login to Trello, the board you chose appears inside a Microsoft Team tab:
We work in an era where work management tools need to be easy to use and accessible to project teams and the stakeholders they support. Trello and Microsoft Planner are direct competitors so the inclusion of Trello integration in the Microsoft Teams Store is yet another sign of the new Microsoft. While too often in my experience, organizations hold a tight rein on things such as the Microsoft Teams Store, more and more.
I’m a technical writer and content development manager living and working in Northern Virginia. Over my career, I’ve written bylined articles for ITSearchOperations, DevOps Agenda, Mobile Business Insights, CNET TechRepublic, and others. My areas of interest include cloud computing, DevOps, enterprise mobility, and collaboration tools. Follow me on Twitter: @willkelly.
Long ago I came to see people as the greater challenge to my work as a technical writer more so than the technology I was writing about. It’s not that I don’t like people. I just came to see people in technology organizations
Here are the five types of people you interview as a technical writer (in no particular order):
Over my career as a technical writer and freelance technology writer, I’ve had the opportunity to interview a lot of whip-smart people — some brilliant — and I’ve learned a lot from them over the years. I’ve grown fascinated by people’s “tells” especially the one type of interviewee I call the Poseur. Here are some of their characteristics:
Now mind you there’s more than one type of poseur. You might get lucky and find one who defers technical writer interviews to their employees politely. There’s no harm in these people — they can be great connectors — for technical writers. It’s the ones who lack self-actualization that can cause problems on content development projects as they become a blocker to success to save face and fight politically to prove their own relevance.
While so many folks fall for the mythos of snake people as the be all end all technology experts, give me an old-school geek with gray hair any day as a subject matter expert. I’m talking about the person who has been there, seen it, and done it.
While interviewing some old school geeks/true believers can mean having to put up some guard rails for the interview because they do have their war stories. Old school geeks are often the ones who respect technical writers with some domain knowledge about what they are writing about versus a generalist who’s not really vested in technology.
In my travels as a technical writer, I’ve come to see that there are just product people. They may hold the formal title of product manager, sometimes they might just be an accidental product manager — a product-focused person sometimes a developer — who has a vision for the product they are developing.
My favorite type of product person to interview is somebody who’s had a lot of customer contact and are very aware of the competitive landscape. These people can be a treat to me as a technical writer. I especially enjoy interviewing product people for articles I’m writing.
A services person understands the delivery side of the business versus the product. They may or may not be technologists by trade. I commonly encounter the services person in industries such as financial services, government, and telecommunications where security, compliance, and dare I say bureaucracy is the order of the day.
My favorite way to interview a person is in front of a whiteboard where they can break processes and procedures down while they are telling they are dropping some knowledge on me.
While I usually don’t see too many of what I call the evangelist when I wrote technical documentation, I do see them when I write articles, blog posts, and white papers. While I like interviewing the evangelist, it can always be a balancing act in my experience. You can encounter a poseur trying to impersonate an evangelist.
Interviewing an evangelist can be challenging. Some come into a media interview with a definite corporate line they want to push even if you are writing a vendor agnostic thought leadership piece. On the bright side, their enthusiasm can be contagious, and that can shine through in their interview answers.
In my experience, natural evangelists are few and far between, but you can cultivate evangelists. I saw that done when I was freelancing for CNET TechRepublic, I saw a corporate CEO go from a very rough interview to one of my go-to sources on a subject in about two years.
While my passion for technology keeps me going as a technical writer — on the good and bad days — people also keep my interest in projects. It could be the people and personalities I work with on a daily basis or the people I interview for articles.
I’m a technical writer and content development manager living and working in Northern Virginia. Over my career, I’ve written bylined articles for ITSearchOperations, DevOps Agenda, Mobile Business Insights, CNET TechRepublic, and others. My areas of interest include cloud computing, DevOps, enterprise mobility, and collaboration tools. Follow me on Twitter: @willkelly.
You must be logged in to post a comment.