How to Onboard a New Technical Writer | HackerNoon

Well, at last, you are not alone in all of these endless tasks. Congratulations. Now, let’s see how to prepare for the new technical writer to join the team.

In general, you would want to reduce the onboarding time and get a team member with the least effort. To do this, you can:

  • Reuse as much information as possible. Document all your processes and regulations to show them to a new colleague. Telling this over and over again will take a lot of time.
  • Create a process. This should work in the same way for all new technical writers.

Preparations

To begin with, you should prepare the Style guide. It will help the new writer to adapt as they learn the recommendations and can refer to them until this becomes automatic. Also, it is much easier to discuss the errors (errors are inevitable at this stage; new team member learns from them). It might be helpful to create a short test to make the newbie remember the guide.

The second important thing is to give time. Never rush, even if the project deadline is close and you desperately need an additional pair of hands. Newbie is in a tough period – lots of new faces and names, even the role itself (in the case of junior professional) may be new. All this brings a lot of stress. Let the new colleague explore the product. The time for exploration depends on the product size and the newbie’s qualification – imagine how many days it would take from you if you saw the product for the first time and add a couple of extra days.

Third idea: give “real world” tasks. To learn the terminology, style, and the docs, this task could be combined with the docs reviewing (for example, looking for errors in the existing docs or translating them). While doing this, the newbie will dive into the product and start building communications with colleagues.

And the next one: teach. Help a lot. Answer all the questions, create meetings with colleagues, and review all texts at least during the first month. This will help the new colleague to be confident and start working as a team member. However, do not overdo this part – gradually withdraw from the processes to help the newbie build their working environment.

Build for the Future

If you plan to expand your technical writing group even more in the future, it is good to write an onboarding guide in the internal wiki. This onboarding guide should contain the following:

  • First-time setup. The required software, VPNs, add-ons, credentials, access permissions, etc. How to get them installed and how to configure them to run.
  • How to log in on a daily basis. Just what you do (or don’t do) to start your work.
  • Work resources. This includes but is not limited to, internal portals, chats, API collections, Style guides, documentation archives, product versions and executables, etc. Everything that is needed for technical writing.
  • Company resources. Helpful things for every employee – HR resources, team building, education resources, benefits, company structure, etc. How to find out whom to report and who can help write certain topics.
  • How is performance tracked and what does the new team member need to do to be considered a normal or good employee.
  • Task trackers and version control systems.

All this should be enriched with links to the resources and kept up-to-date, as it is a great place to refer to and to reduce the time on explaining the same things over and over again.

Summary

To sum up:

  • Make the Style guide and use it to teach the newbies.
  • Provide enough time to let the newbie feel confident.
  • Give real tasks with real products and docs.
  • Answer all questions.
  • Write the onboarding guide with all the required information to start and carry on the work.