To apply for a technical writing job—particularly if it’s your first role—you’ll need a few essentials, just like most other “white collar” jobs:

• A résumé
• A cover letter
• A LinkedIn profile

One thing that sets technical writing apart is the ability to showcase your excellent work. This is a great way to prove your skills—and employers often request it in an interview. So you’ll need one other essential:

• A portfolio of your own writing samples.

To help make this process less daunting for you, we’ve broken down each of these essentials below, giving you tips plus dos and don’ts to give you the best chance of landing a new role—and understanding what’s expected of you.

Resume

You must have a résumé or CV to apply for just about any technical writing job.

What Does That Mean?

Résumé or Curriculum Vitae (CV) A résumé (also known as a CV, or curriculum vitae) is a summary of your skills, responsibilities and achievements (work experience), and qualifications. Its purpose is to snag you an interview by proving to a prospective employer that you have what it takes to do the job. Think of it as a foot in the door to get you through to the interview stage.

Here’s a list of dos and don’ts for writing your résumé.

Dos	Don’ts
Be concise, and put the most relevant information on page 1. No hiring manager wants to wade through an essay-length résumé—in fact, many resumes aren’t even read beyond the first page. However, expectations vary between countries. In the United States, the norm for résumés is generally one to two pages. However, in some jurisdictions (such as the UK, Canada, and Australia) a longer résumé or CV can be acceptable. Talk to a recruiter in your industry if you’re unsure.	Don’t include irrelevant experience. Leave trivial details off your résumé. Employers want to read about your technical writing accomplishments, not that you were responsible for minute-taking in your high school debating club. Additionally, if you have strong experience in something but you no longer want to go down that path, minimize or remove it from your résumé, or it will keep getting picked up in keyword searches by recruiters.
Be professional. Include a professional-sounding (or at the very least, inoffensive) email address, not the risqué or jokey one you had in high school or college.	Don’t give a potential employer reason to discriminate (even unconsciously) based on irrelevant factors such as your: Marital statusReligious affiliationPhysical appearance (age, race, gender, disability) Although profile pictures are the norm on professional networking sites such as LinkedIn, you don’t have to include them in your technical writing résumé.
Be specific and focus on results when describing your accomplishments. Write “Wrote 11 successful grant applications” instead of “worked on grants.” If you’re coming from another industry, frame your transferable skills so that recruiters and hiring managers can easily understand how they apply to technical writing.	Don’t lie or overstate your experience. If an organization needs a senior writer with specific skills that you don’t have and you somehow land the role, you won’t be successful or happy, and that will be bad for everyone—and most of all, your reputation.
Follow a standard résumé format. The most common formats are chronological or functional, which is sometimes used when switching careers. Whichever one you choose, be consistent and ensure it makes sense. A chronological résumé lists your experience in descending order of most to least recent.A functional résumé lists your experience under topical headings, such as “technical writing experience,” “business analysis experience,” and so on.
Follow good technical writing design principles when you’re formatting your résumé. If you’re using Microsoft Word, make sure you use consistent heading styles, and don’t introduce any ad hoc formatting. For more information on styling documents, see Chapter 16: Design Stylesheet.
Edit your résumé for typos and errors. Your résumé doesn’t need to be a work of art, but it does need to be free of typos, grammatical errors, and other mistakes. Particularly if you’re applying for technical writer roles, attention to detail is a key soft skill that employers will be looking for.
Include keywords from job ads. Many résumés are scanned automatically by software that looks for keywords that match the job ad before they’re ever seen by a human. So if the job requires a key credential, skill, or experience with a particular technology, make sure it’s mentioned in your résumé! Provided you do have that experience, of course.
Send it to a friend or family member to review. When you’re crafting your résumé, you’ll probably redo it so many times that you’ll lose perspective on it. Having a fresh pair of eyes can find mistakes you missed, suggest better ways of phrasing your responsibilities and accomplishments, and give you a better idea of how it might land with employers.

LinkedIn Profile

LinkedIn has become the default place to express your professional identity worldwide. Having a LinkedIn profile is essential for job seekers as it allows recruiters to find you using keyword searches and easily contact you. It also makes it easier to network with other technical writers and even apply for jobs using your LinkedIn profile (though it’s a good idea to still have a résumé).

Here’s a list of dos and don’ts to help you craft a strong LinkedIn profile.

Dos	Don’ts
Add a photo of yourself. Unlike on a résumé, photos are the norm on LinkedIn. Add a professional-looking photo of yourself, cropped to show only your head and shoulders, against a simple or plain background. Make sure you’re the only one visible in the photo.	Don’t give a potential employer any reason to turn you down. This includes anything potentially contentious, such as liking a politician’s LinkedIn post, even if you’re not intentionally being partisan. Savvy employers will scour your LinkedIn profile and anything you’ve posted or liked to see if there’s anything in there that might cause scandal or simply be against their personal beliefs.
Be mindful of posts you’re tagged in, particularly where they’re accompanied by pictures. Check your settings on your personal social media as well (Instagram, TikTok, YouTube). Are your personal photos visible to anyone? If so, do they portray you in a professional light? Even something as innocuous as enjoying a glass of wine might seem unprofessional to some employers if it clashes with their strongly held beliefs.	Don’t post “jokey” or sarcastic responses to other people’s LinkedIn posts, however tempting that might seem. Keep it professional, even if that means being a little bland. Just like anything politically controversial, it’s best to keep it vanilla on LinkedIn. Save your snarkiest commentary for your alter ego on Reddit or somewhere a potential employer won’t link it back to you and find offense.
Add a concise headline that briefly describes what your key strengths are and how those relate to the career you’re aspiring to. Here’s an example; “Wordsmith with Technical Acumen | Self-Made Coder | Customer Service Professional | Aspiring Technical Communicator.”	Don’t be excessively negative in your posts. Some folks can’t seem to help posting very negative comments, particularly about recruiters and the hiring process. Whatever your personal thoughts or experiences (and we’re not saying that people haven’t have bad experiences!), keep your diatribes for another forum. If potential employers see you posting negatively, they may think you have a chip on your shoulder that could express itself in a negative, morale-eroding attitude at work.
Tell a concise story about yourself in the about section. This will be an example of your writing style and abilities, so take your time to make it shine. Be authentic so you sound like yourself (first person, and not too “salesy” or “corporatey”). Something like: “I’m Lee Anne. For the past two years, I’ve been writing tech support content. I love learning from my amazing SMEs and am looking for a role that values collaboration over competition.”
Complete all sections in your profile.LinkedIn seems to prioritize complete profiles over incomplete ones in search results. Add any skills, education, work experience, awards, languages, certifications, and licenses you may have.
Engage with posts from companies you want to work for by liking them, share interesting articles about technical writing, join industry groups, and react to and comment on other people’s posts. LinkedIn seems to rank active users more heavily in recruiter search results.
Ask for recommendations from former managers, colleagues, or mentors. Even if you were in a completely different role from the one you’re aiming for, having a glowing review of your communication skills on your profile will emphasize to a prospective employer that you have the right attitude to be a technical writer.

Tip

Customize Your LinkedIn URL for Your Résumé You can customize your LinkedIn profile URL so it doesn’t have a mess of letters and numbers at the end. This will look better when you include it in your résumé.

Cover Letter

When applying for a technical writing position, you’ll often need to include a cover letter. In a few paragraphs, a cover letter gives you the opportunity to explain why you’re interested in the role and the company, and the value you’ll bring to the role through your unique combination of hard and soft skills, experience, and accomplishments.

In a writing-heavy field such as technical writing, a cover letter carries extra weight. It’s a great opportunity to showcase your writing skills. On the flipside, poor writing or grammatical errors will reflect badly on you and be glaringly obvious to a potential employer. Because writing is a core part of the job, recruiters and hiring managers will scrutinize any writing you provide during the application process, so make sure it reflects your talent.

Table: Dos and Don’ts for Technical Writer Cover Letters

Dos	Don’ts
Tailor your cover letter for the role. This goes for your résumé as well. Look at the sort of qualifications, skills, and experience the job ad is asking for, then see if you can find examples in your career where you’ve already done those sorts of things. Highlight these in your cover letter by summarizing them in bullet points.	Don’t use generic copy-and-paste letters that are the same for every role. At the very least, make sure you address the hiring manager or recruiter by name, rather than “Dear Sir / Madam.”
Keep cover letters to less than one page. They should be brief and to the point, highlighting only your most relevant skills and accomplishments.
Try to put yourself in the shoes of the hiring manager or recruiter. The more directly and obviously your cover letter answers the question “How does the candidate meet my requirements for [key qualifications / skills / experience],” the easier it is to say yes to that candidate.
Reference the job title and job ID (if there is one) in your cover letter. Remember that hiring managers and recruiters often recruit for multiple roles at once, and sometimes they lose track of things.
If time permits, ask friends or family members to review your cover letter—along with your résumé—before you send it to get a fresh perspective.

Tip

Don’t Have Much Tech Writing Experience? Cover letters are especially useful when you’re new to the industry. If you’re transferring into technical writing from another field, you can use your cover letter to explain how your previous experience and skills are relevant and transferable. If you’re a recent graduate from a school, bootcamp, or certification course, you can use your cover letter to explain why you chose technical writing and what skills you can offer the organization.

Portfolio

Portfolios are excellent tools for showcasing your ability to clearly communicate technical concepts. In fact, many technical writing roles require at least several writing samples with your application. Portfolios can be especially valuable to aspiring technical writers, as they’re an easy way of proving to a potential employer that you can do technical writing, even if you don’t have much formal technical writing experience. For experienced writers, portfolios are an excellent way to showcase to potential employers your amazing writing and presentation skills, which their team will benefit from.

Portfolios can take many forms, varying wildly depending on the time and financial investment you’re prepared to put into them. What matters is that your writing samples are high quality—well written, structured, and formatted—demonstrate your understanding of technical writing concepts, and are easy for potential employers to access.

Technical writers often use a variety of different formats for their portfolios:

• A personal website with a custom URL
• A content management system such as WordPress
• A code hosting platform such as GitHub
• A document hosted online (such as a Google doc) that contains summaries of work samples or links to them

Be careful when you’re preparing your portfolio that you don’t disclose any sensitive intellectual property you don’t have permission to share.

What Does That Mean?

Portfolio A portfolio is a collection of your own work samples from organizations you’ve worked for and that you have permission to showcase to prospective employers.

Good prompts for writing sample portfolio pieces include:

• How to write an email (use the device/program/browser of your choice).
• How to download images from a device.
• How to download an app to your phone and use it.
• How to order groceries online.
• How to send images through a social media platform.
• Compare and contrast the use of a laptop/desktop with that of a tablet/phone to complete a task.
• Compare and contrast the use of two different programs to complete the same task.
• A troubleshooting guide for something in your home/daily life that sometimes malfunctions.
• Table or graphic comparing two programs/products.
• Define terms (app, program, HTML, CSS).

For more advice about choosing writing samples, we recommend you read Sue Arkin’s post, The Dos and Don’ts of Writing Samples¹ in her blog, Tested Writing.

Tip

How Do I Build a Portfolio if I’ve Never Done Any Technical Writing? If you’re an aspiring technical writer and don’t have any published samples from a previous job, that’s okay. Many aspiring technical writers find themselves in the same position. Consider creating some documentation using the principles outlined in this guide. If your samples showcase your technical skills as well—for example, some amateur coding projects you’ve done—even better.

Dos	Don’ts
Writing samples should be long enough to provide context and showcase your communication and or technical abilities but short enough that a hiring team can review them easily. Keep each sample to less than a page. If possible, use pieces that are most relevant to the role you’re applying to.	Avoid weak samples that don’t showcase your best abilities, or samples that aren’t tech-docs specific. For example, some folks include a broad range of writing projects, such as short stories, screenplays, poetry, and so on. This is best left for your personal website rather than your professional portfolio.
Include sufficient context alongside your samples so that employers can understand them: the organization (or industry if you’re not allowed to mention the organization by name), audience, tools or techniques you used to write the samples, any challenges you had to overcome, the positive impact your pieces had (e.g., reduced support calls, or were described in glowing terms by a customer in an online forum).	Avoid highly idiosyncratic portfolio sites that may make you seem just a little too quirky. Once you’re in the workforce and your teammates get to know you, you can judge whether it’s safe to let your hair down and show your true self. It’s all too easy for a potential employer to turn you down based on an impression from a website before they get a chance to know you—and appreciate your unique strengths.
Include a link to your portfolio in your LinkedIn profile and at the top of your résumé.
Try and make your portfolio links public if you can. It’s no good having a portfolio if a recruiter can’t see your work!
Ensure that you have permission to share any proprietary work that you have done for a former employer—and that it isn’t behind a paywall or nondisclosure clause in your contract.

Voice of Practitioner

Jerome Role: Technical Writer with 4-plus years’ experience and 10-plus years’ language and writing tutoring Location: Washington, United States Expertise: Software documentation “My portfolio has been one of the strongest things to qualify me for roles. If you don’t have any experience in tech writing, it is entirely up to your portfolio. People didn’t even look at my résumé until I had a strong portfolio. To get my first tech writing role, I volunteered for open-source work and landed a gig at the Google Season of Docs project. I worked with the Madplotlib Project,2 and they enjoyed my proposal. I developed a lean style guide, some docs, and documented an entry path for someone who was entirely new to programming, noting there were loads of online resources such as YouTube available. I noticed gaps that needed to be in the entry path that weren’t in the docs and highlighted that to them. I like to say ‘open-source opens doors.’ However, open-source projects is developers doing it out of passion, it’s a labor of love, so there can be a high barrier to entry there. It’s a tight-knit, closed community.”

1. Arkin, S. (2022, April 2). The dos and don’ts of writing samples. Tested Writing. https://arkinwriting.com/2022/04/02/the-dos-and-donts-of-writing-samples/ ↩︎
2. Matplotlib project. (n.d.). Google for Developers. https://developers.google.com/season-of-docs/docs/2020/participants/project-matplotlib-jeromev ↩︎