Search results

Put together a portfolio (TW Job)

Series: How to get a job in technical writing

by Tom Johnson on Dec 21, 2009
categories: beginners

The portfolio is the most important work you can put together when looking for a job. A good portfolio can make up for years of experience. You can have 20 years of experience as a technical writer, but if your portfolio is uninteresting or doesn't sell yourself, you won't get the job. Conversely, if you have just 1 year of experience but have an impressive portfolio, you might have a better chance of getting the job.

There's a reason that putting together a portfolio is step four. You can't put together a good portfolio until you know a bit about technical writing. For example, if you just jump right into the portfolio and start creating samples that show a full screenshot with each step in a generic Microsoft Word document, your portfolio will be poor and will work against you. You need some theoretical grounding before you can create worthwhile documentation. You need real projects before they are convincing. And you need some knowledge of industry tools before you can create an attractive-looking design.

When putting together your portfolio, keep the following best practices in mind:

  • Include 10-15 samples, covering a variety of formats and writing situations. For example, include quick reference guide, a user guide, online help file, video tutorial, newsletter article, release note, magazine article, and any other format you can think of (including some college essays, perhaps).
  • Provide a web-based version of your portfolio. Employers may want you to leave the portfolio with them, and some may require you to submit the portfolio through email, so you'll need a link to a website with a digital portfolio. I recommend a self-hosted WordPress site for this. See "Developing a Web-Based Portfolio" by Steven Kendus for more tips.
  • Provide a brief paragraph introducing each work, the situation, purpose, and tool you used to create it.
  • Make sure your portfolio samples are free of typos or grammar errors. The employer won't be able to review the accuracy of your steps (which is probably the most important component of help). What's left is to focus on the way it looks and reads. Make the layout professional. Clean up the writing so that it's flawless and graceful.
  • Include your transcript in your portfolio. Employers will be curious to learn what courses you've taken that qualify you to be a technical writer. Additionally, if you've done well in these courses, it will show your aptitude.

Most likely you won't have a ton of writing samples. If you completed step 2 ("Get Real Experience Doing Technical Writing"), you'll have a few samples you can show. But you probably need more. Here's a great tip from Barbara Block in "Finding That First Job." Can you document how to do your job? (You have a job, right? ) Are there concepts and tasks to master? Steps to perform for each of the tasks? Your current employer might appreciate this little handbook you create, and it can be a perfect addition to your portfolio.

When you go to an interview, always bring a portfolio of your work to leave with an employer. (Don't expect to really get these back, by the way.) The employer will want to peruse your writing both before and after the interview. Know also that a portfolio provides perfect talking points during an interview.

When I was looking to break into technical writing, I brought a portfolio with about 15 samples to the interview. I later learned that it was an article I wrote about protein that impressed one of the interviewers (who had a PhD in biology). I also had a sample online help file that I created with RoboHelp as well. I beat out 5 other candidates without having any actual technical writing experience. Trust me -- the portfolio is key.

About Tom Johnson

Tom Johnson

I'm an API technical writer based in the Seattle area. On this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, AI, information architecture, content strategy, writing processes, plain language, tech comm careers, and more. Check out my API documentation course if you're looking for more info about documenting APIs. Or see my posts on AI and AI course section for more on the latest in AI and tech comm.

If you're a technical writer and want to keep on top of the latest trends in the tech comm, be sure to subscribe to email updates below. You can also learn more about me or contact me. Finally, note that the opinions I express on my blog are my own points of view, not that of my employer.