Just Write Click

Technical writing with Continuous Integration and docs-as-code

  • JustWriteClick
  • Contact
  • Books by Anne Gentle
  • Introducing Docs Like Code
You are here: Home / social media / Wiki technical writer – job description

August 27, 2009 by annegentle

Wiki technical writer – job description

I found this “wiki technical writer” job description the other day and thought about the ideas in my book. Yippee! Companies are starting to demand the skills and strategies outlined in my book.

Here’s the job description, pasted from the STC Silicon Valley website.

Description:Oak Hill Corporation is currently looking for a Technical Writer with administrative-level experience using Confluence (or another major Wiki tool) to migrate and develop product documentation for one of our clients. The migration task requires some information architecture. This is an on-site full time position. The contract will be about 6 months and could result in a permanent position with the company.

Requirements:

* Bachelors degree in Computer Science or related field
* Thorough understanding of the business usage of wiki technologies (2+ years)
* Administrative knowledge of and experience with Wiki engines, preferably with Confluence or MediaWiki (2+ years)
* Experience documenting technical customer and developer materials
* Portfolio of work showing experience

Required Skills:

* Ability to design, implement, and maintain wiki namespaces and pages
* Ability to migrate legacy documents to wiki
* Ability to architect scalable wiki namespaces and page linking layouts
* Ability to create wiki templates
* Ability to fully utilize tagging and labeling wiki functionalities
* Excellent writing and communication skills
* Understanding of software development life cycle

www.oakhillcorporation.com

Upon closer inspection I realized it is a six-month contract position, that may lead to a permanent position. One interpretation of the fact that it’s a contract position is that the company housing the Confluence wiki really only needs to use the wiki as a web CMS, not as a community site. That’s a valid use of the tool as it offers more interactive, shareable content than most help authoring tool outputs. Check out this case study on the Atlassian site for more information on using Confluence for user assistance.

Another interpretation is that the company hasn’t found anyone with this unique skillset and is hoping the Oak Hill Corporation’s reach will help them find that unique person. In a contract position, the technical writer will have to work hard in six months to establish themselves as a member of the community, as long as their online identity would be permanent enough to allow them to earn attribution on the content. Perhaps a writer who embraces the community would earn the permanent position, though.

I hope to see more job descriptions like this one. I know I see more and more demand for these skills and for user assistance on the web that blends well with the rest of the web content out there, is shareable, findable, and ultimately solves users problems.

What are you seeing? Is there demand for this type of content with these types of tools and skill sets? Are technical writers the ones filling the demand?

Related

Filed Under: social media Tagged With: community, social media, social networking, technical writing, techpubs, wiki

More reading

Bubble graph showing sources of developer support data

I’ve been thinking a lot about developer support at Cisco recently, especially for the way the world works today with multiple cloud providers. This post is a re-publish of my talk from over five years ago, but the techniques and tools for listening and helping others are still true today. At Rackspace, we watched several […]

Cisco DevNet is our developer program for outreach, education, and tools for developers at Cisco. From the beginning, the team has had a vision for how to run a developer program. Customers are first, and the team implements what Cisco customers need for automation, configuration, and deployment of our various offerings. Plus, the DevNet team […]

I had a great talk with Ellis Pratt of Cherryleaf Technical Writing consulting last week. Here are the show notes, full of links to all the topics we covered. Podcasts are great fun to listen to and participate in, if a bit nerve-wracking to think on your feet and make sure you answer questions succinctly […]

At the beginning of this year, I worked hard to summarize my thoughts on API documentation, continuous publishing, and technical accuracy for developer documentation. The result is an article on InfoQ.com, edited by Deepak Nadig, who also was forward-thinking in having me speak to a few teams at Intuit about API documentation coupled with code. Always […]

Recently on Just Write Click

  • A Flight of Static Site Generators: Sampling the Best for Documentation
  • Try a GPT about “Docs Like Code” to ask questions
  • Discipline and Diplomacy: Docs in the Open
  • Let’s Find Out: When Do Static Site Generators Do Rendering?
  • GitHub for Managing Tech Docs

Just Write Click in your Inbox

Enter your email address to subscribe to Just Write Click and receive notifications of new posts by email.

Read More

  • Privacy Policy
  • About Anne Gentle, developer experience expert
  • Books by Anne Gentle
    • Conversation and Community
    • Docs Like Code, a Book for Developers and Tech Writers
  • Woman in Tech Speaker Profile
  • Contact

Books

  • JustWriteClick
  • Contact
  • Books by Anne Gentle
  • Introducing Docs Like Code

Copyright © 2025 · WordPress · Log in