fbpx
Our Best Words Blog

Today, it is becoming more important to become a qualified technical writer.

More than 75% of technical writers worldwide have moved into technical writing as a pivot. Career changers bring their expertise in many different fields to their new careers in technical communication . They use their qualifications from other industries to broaden their vision and understanding of the role. As most technical writers have different professional backgrounds, they often lack any degree in Technical Communication and instead have a certificate from a local training facility. 

Pivoting into TechComm

Jordan has a BSc in computer science and a background in software development. He moved to Israel recently and decided that he wanted to change his career. Combining his love for technology and for writing in English, he decided that technical communication was the answer. He completed his courses at an online training facility and received a certificate as a technical communicator. He quickly found a position and his career has grown along with his knowledge. He is now a sought-after candidate for technical writing positions in Israel’s dynamic hi-tech market. 

Becoming a Qualified Technical Writer

Olivia was a freelance translator who was looking for better job security. She found an internship program, took some classes, and started her career in Technical Communication. For Olivia, an internship gave her the experience, while the courses gave her additional practice. The mentors that Olivia worked with hired her to work as a junior technical writer and a few years later, she was promoted to a senior writer’s job. Shedecided after a few years to become an independent contractor and to take advantage of the “gig economy” during the pandemic. She took a class to get certified in technical communication so that her experience could be ratified by international authority and give companies across the EU a reason to consider her. Today, she has clients knocking on her door and feels that her training and certification, in combination with her experience, gives her a big advantage  over the competition.

Investing in Professional Development

Tania has a BA in journalism and media and decided to take a training program in technical communication to give her additional advantage in the job market. For the past 8 years, she has worked as a technical writer for a start-up ad-tech company. Tania was worried her skills would start to stagnate if she didn’t invest in her personal development. She wasn’t sure how much longer the start-up would last. She wanted to make sure that, if something happened to the company, she would be ready to enter the job market as a desirable candidate. So, Tania took some additional classes and also decided to certify in Technical Communications. When her company decided to close, thanks to her new skills and experience, Tania quickly had several relevant offers from large companies. 

Jordan, Olivia and Tania have one thing in common. All of them are certified in technical communications by ITCQF, the International Technical Communication Qualification Foundation

What is ITCQF?

ITCQF, the International Technical Communication Qualification Foundation, is a non-profit organization committed to professionalizing the industry by certifying technical writers all over the world. They have set an international standard for technical writing, just as the International Software Testing Qualifications Board ISTQB does for QA professionals and IEEE does for engineers. Their examinations are set and monitored by the GASQ.

The ITCQF certification never expires and is recognized all over the world.  ITCQF training centers provide courses to prepare their students for the certification exam. All training sessions are delivered by instructors who are ITCQF accredited.  

ITCQF certified professionals can be found working in leading companies around the globe, including: Google, Motorola Solutions, Siemens, and Atlassian. Once you become part of this elite network, you will have many more colleagues you can collaborate with, and who can provide you with work opportunities. 

Why should I get certified in Technical Communications?

The ITCQF certification is an internationally known and accepted certificate administered by the GASQ. Their standards are set by leaders in technical communication and their certificate never needs to be renewed. This certificate qualifies you for the job title of technical writer and gives you formal proof that you have been taught the necessary skills for the profession. An international certificate will give you international recognition in the job market, and employers will turn to you over other non-certified candidates. As more certified individuals enter the job market, certification will become a requirement. Having it now puts you at an advantage among an elite group of individuals who have decided to achieve international recognition for themselves in the technical communication profession. 

Today, many companies are looking for qualified technical writers. You can open the door to higher-paid opportunities with a certificate from the ITCQF. Walk into that interview with confidence in your skills and something more to talk about. Internationally, certification is going to become a requirement for the job, so it is only a matter of time before this becomes a requirement in Israel’s competitive market. Don’t be the last person to invest in your own career development! 

Where can I take an ITCQF course?

There are ITCQF training centers in 12 countries including the US, Australia, the UK, India, and across Europe. Companies often have technical writers scattered between their workspaces, so they have training facilities for this certification path in multiple locations, which makes getting certified easier than ever. In 2022, for the first time, this international certification program is now available online from Israel, with live online courses open to anyone anywhere in the world for whom the synchronous evening classes are convenient. 

Our Best Words, the only accredited training organization for the ITCQF in Israel, is leading the way to training technical writers to become qualified and certified.  The Our Best Words online training program teaches you everything you need to know to pass the certification exam. The ITCQF course can be taken by experienced techcomm professionals as a stand-alone course, or at the end of  of our flagship Technical Communications Foundations training program. 

What are you waiting for?

Becoming a qualified technical writer is the easiest way to set yourself apart from the competition. The ITCQF certification program provides the most advantages since it meets industry-wide standards.  If you aspire  to break into international markets, you will have many more opportunities through becoming an ITCQF certified technical writer.  You  will know that your skills and knowledge are backed by a respected international organization. Your employers will be satisfied that their content is safe in your very capable hands. Here in Israel, you will join an elite group of individuals who feel that certification from ITCQF is an essential step in qualifying your skills in a larger arena. 

Click here for more information or sign up TODAY for the ITCQF Online Training Course starting August 9, 2022!

One of the most rewarding jobs for people who move to Israel from English-speaking countries is technical writing. But you don’t have to be a tech geek to become a technical writer!

Israel’s tech industries are always looking for technical writers. But we’re not only talking about hi-tech – today Israeli companies are specializing in bio-tech, green-tech, fin-tech, agri-tech, and canna-tech (cannabis research and production) are all growing fields!

You might think that you have to have a technical background to become a technical writer, but that’s not true. One of Our Best Words’ most successful recent graduates, Avi Chazen, used to work in tourism and is now a technical communicator for a global software company.

“I was looking to pivot out of tourism even before COVID because I enjoy learning new things”, says Avi. “It turns out that being a good communicator gave me an advantage as a writer, because I am good at communicating freely with developers to understand what needs to be documented. To become a technical writer, you don’t need a technical degree. You just have to be technically competent, organized, and a good communicator. If you can take complicated information, understand it, and make it accessible to others, you can work in technical communications.”    

What do Technical Writers Do?

You can work in-house for one company as a technical writer, information developer, or documentation manager, or you can work as a freelance technical writer for multiple companies. Your main work would be writing user guides and release notes for technical products. You need to think like a user in order to translate the developer’s jargon into simpler language. Technical communication professionals may also help with designing the user interface for products.

Our Best Words observed a trend among hi-tech start-ups who want people who can not only write their technical documentation but also their internal documentation, and their marketing materials, such as white papers. 

STOP PRESS: The free trial class at our next Open House on Sunday, July 25 is about
writing white papers and other content to sell technical products. Click here to sign up!

Israeli companies, in particular, may even ask their English-speaking technical writers to write their promotional campaigns and run their social media campaigns. If you can offer MarCom expertise alongside your TechComm skills, this will help to bump up your salary! (That’s why Our Best Words offers a combined course in Technical Writing & MarCom)

How Can I Learn Technical Communication?

The good news is that you don’t need to go back to school to become a technical writer. Our Best Words offers a 5-month course taught in the evenings, so that people who are working during the day can participate.

Our Technical Communication Foundations course runs over 15 weeks, with classes on Tuesdays and a follow-up Lab or discussion session on the following Monday. This course is taught by our Principal Technical Communication Lecturer Leah Guren, who is a Fellow of the STC (Society for Technical Communication) and a founding member of Tekom Israel. 

Also on the TechComm team at Our Best Words are FE King and Laura Novich, two highly experienced technical writers and ITCQF Certified Instructors, who sit on the International Technical Communication Qualifications Foundation Board and prepare our students for ITCQF certification. Laura teaches Advanced Technical Writing Skills and Technology for Software TCs. She also helps our students to find internship projects (such as GitHub) and paid employment.

How much could I earn as a Technical Writer?

Our Best Words invests enormous efforts to find work for all of our course graduates. We not only run workshops on how to find work, and help students to optimize their resumes and LinkedIn profiles, but we also look out for opportunities for them in Israel’s dynamic tech markets, and leverage our contacts to get them interviews with good companies.

Some of our 2020 graduates are already earning salaries of between 14,000 – 17,000 NIS per month shortly after completing the course. (You can find out more about what technical writers earn from the international 2020 Write the Docs Salary Survey).

So, if you are wondering whether Technical Communication could be a good career move for you, we’re here to answer your questions and help you make the right decision. 

Click here to join our Virtual Open House on Sunday July 25, 2021

Looking back, 2020 was filled with uncertainty and trepidation. Would we be able to open a Technical Communication class at Our Best Words on Zoom? Would Covid-19 allow our students to work and study? How many would lose their jobs? How many would get sick? So many questions, and at the beginning there were very few answers.

As the year progressed, we discovered that not only did we have enough students to teach,  but we also had four successful internships and amazing final projects. Our students were challenged intellectually and technically. They learned complex concepts, complicated tools, and how to create workflows and diagrams. In the end, we persevered and rose to the challenge. They all successfully completed their projects and their work speaks for itself.

API = Application Program Interface

As a part of my Advanced Software Documentation module, my students learned about open source software and learned how to document APIs. I admit that I was a bit skeptical about bringing something so complicated to my students. API documentation is not for everyone. An Application Program Interface is an interpreter between two devices or endpoints, similar to a waiter who interfaces between the kitchen and the customer. Almost every software company uses APIs or develops them, so understanding how an API works and how to document it would be an advantage for any junior technical writer who is learning the tools of the trade.

If you have never looked at code, it can be quite difficult to really understand and document APIs correctly. I decided to use the open source philosophy and to ask the community for help. I contacted the Write the Docs group and they gave me so many ideas that I wasn’t sure how to use all of them!

Alex Fiedler offered to share his API Documentation Exercise and was always available to answer questions. His exercise was more complicated than I wanted, so I simplified it by restricting the choices, but I didn’t simplify the code. This modified exercise was the final project for the API mini-course, which was part of the larger Advanced Software Documentation course at Our Best Words.

Once I had the content, I decided that the API mini-course was too short to allow me to teach a new API documentation tool such as Swagger or Postman. As the content was going to be hosted on GitHub, I wanted to give my students Markdown templates for writing the docs. The community answered this need as well. The Good Docs Project has templates for many kinds of docs including API documentation. Their templates include a readme which explains how to use each kind of template. It is written in Markdown and hosted on GitHub. Check it out and contribute to making the project better!

Whenever I had a question, the Slack group at Write the Docs was more than ready to help. Special mention to Alyssa Rock and Chris Ward, who were more than helpful in answering questions with patience and care.

So, if you have read this article to the end and are wondering how you can learn to write API documentation, here are some tips:

  1. If you want to learn the course with an instructor, Our Best Words offers a mini-course in API documentation as part of their Advanced Software Documentation course.
  2. If you want to teach yourself, there are some courses which are really good. Tom Johnson has a blog called I’d Rather be Writing.
  3. Learn a bit of JSON, REST, or Python. You don’t need to know how to write a program but you do need to know how to read and analyze one. In the same way that a psychologist learns statistics in order to be able to understand correlations, a technical writer needs to be able to read code snippets and understand what they do.
  4. Showcase your work. Use the static site generator from GitHub to create a website of  your docs. If that is not an option, just host it on GitLab or GitHub.

Laura Novich MSc, Advanced TC Skills Lecturer

Laura Novich

Laura Novich entered into technical writing in 1997 and has worked in both startups and fortune 500 companies in diverse fields such as virtualization, cybersecurity, and enterprise cloud solutions on both Windows and Linux platforms. Laura is a regular contributor to “Open Source” magazine, is a founding member of “Write the Docs Israel”, and is highly recognized for her contributions and maintenance to Fedora’s open-source documentation (in KVM). She is a frequent presenter at MEGAComm and has had speaking engagements at the Red Hat KVM forum and has attended several hackathons. Laura has won the prestigious Red Hat EXCeed award for her outstanding collaboration work as well as the 3Com 3Award for her outstanding work in managing the ATM documentation project. In her current role, Laura is building and managing an open-sourced documentation community at ScyllaDB, where developers, customers, and open-source activists can contribute.

Laura’s diverse career history includes educating new immigrants in English (ESL). In this capacity, she was selected to be a curriculum writer for her school district and a teacher trainer for the NY state ESL aptitude test (NYSESLAT).

Laura has a rich set of hobbies and volunteer work, which includes being a mentor for FIRST robotics teams, genealogy, baking, and cake decoration.  In addition, Laura is currently documenting her grandfather’s extraordinary life and together with her husband, Jason they manage and maintain a community library with over 2,000 titles.

Laura has both a B.Sc. in psychology an M.Sc. in TESOL and is a licensed English teacher (K-12) in Israel and the USA. Laura is a Red Hat Certified System Administrator.

In the movie The Secret of My Success, Brantley Foster (played by Michael J. Fox) expresses exactly the thought that goes through every graduates’ mind: “How can I get any experience until I get a job that gives me experience?”

The hardest thing to do when starting a new career, is to get experience. Often this creates a paradox. How do you get work with no experience, and how do you get experience with no work? 

In the world of open source software, this conundrum is a bit less daunting because your experience is what you make of it. By working with Open Source projects – sponsored by open source software (OSS) companies – you gain experience working on projects you like, for companies which make you feel you are important, and then you use that experience to help you find employment. 

Most companies would never allow newbies to touch their intellectual property and collateral without signing a NDA or going through some kind of training or security check. However, when your source code is open and anyone in the world can contribute to it (in addition to copy it and use it), this is no longer an issue. In fact, open source companies embrace their contributors and create communities where students can easily get their feet wet and find their way in coding, testing, and documentation. Most open source companies depend on the contributions of others to get work done. This means that the contributors work for free, simply because they want to. For students, it translates into an unpaid internship and getting some real-world experience. 

At Our Best Words, we decided to run a pilot project to see if our students could work in an open source documentation project and find the experience beneficial to jump starting their new careers in technical communication. 

I was the initiator and point of contact for the project and I approached several companies. The one company which gave us the most positive response was GitLab. GitLab is a company who creates software for Git repository management, issue tracking, and CI/CD (continuous integration / continuous delivery) pipeline management. Their software is used by hundreds of thousands of organizations worldwide and in 2019 they announced that they had achieved $100 Million of ARR (annual recurring revenue). 

I was contacted by Mike Jang of GitLab and he connected me with Marcin Sedlak-Jakubowski and Marcia Dias Ramos who were located closer to OBW’s offices in Israel. Following the meeting, the details were hammered out and everyone had their tasks to do in order to launch the pilot in mid-September.  Mike, Marcia, and Marcin hand-picked 19 issues for the students to solve. Each issue would be tagged Tich-Tov-only for OBW students, and any contributor who was not an OBW student would not be allowed to work on the issue. 

To prepare the students, I held several demonstrations with GitLab. The students had never used the software before and some were quite nervous. As the backbone of GitLab is Git, a software tool which the students were already familiar with, it wasn’t too hard to learn. Following the demonstrations, I sent the students a link to a Google drive folder with tutorials, a FAQ, and other valuable resources. 

The issues the students were assigned came from GitLab’s documentation. The documentation is written in Markdown and is checked with a linter (a static code analysis tool) called Vale. The student’s assignments were to fix issues that the Vale linter had found. The changes included: fixing spelling, grammar, usage, and voice. In some cases however,  entire pages had to be re-written.  

As I wanted this project to run smoothly and successfully, we decided to limit the pilot to 7 of our 14 students. This allowed me to manage the project more closely, and to make sure each student had only 2-3 issues to handle during the 2 month time period that the project was active for. 

The OBW students who were part of this project (with links to their GitLab profiles) were:

We worked mostly during the months of September and October and wrapped up the project in November. Each issue the students had was put on a Trello Kanban board. We had regular standup meetings where  we discussed what we were doing and discussed any issue which was causing difficulty. There were many teachable moments where I would help with repository issues, troubleshooting issues for the merge requests, and helping the students understand technical writing theories in practice. 

November came faster than we thought it would and looking back, the project ended way too quickly. About midway in, I collected feedback from Marcin, Marcia, and Mike and they told me that the experience for them was a positive one. They told us that once we were done, we could if we wanted, take on more issues than the original allotment which had been assigned to the group. 

One student in particular did just that. That student was Rachel Gottesman. She completed 33 Merge requests and helped rewrite pages of GitLab’s documentation. She was so instrumental for the 13.7 release, that GitLab announced that Rachel is the MVP for the release! We at OBW couldn’t be more thrilled! Congratulations Rachel!

Rachel’s name will appear on GitLab’s MVP page. The announcement for the release is in this blog post

Our semester has ended and our students are graduating and will soon find employment. We are gearing up for our new year and a new course. We plan to run this project again as part of our Software Documentation for TC Professionals course.

If you are interested in learning more about this valuable internship opportunity, come to the Our Best Words Open House Event on Sunday, January 10. Click here for more information. We look forward to meeting you!

Laura Novich

Laura Novich is Our Best Words’ Advanced TC Skills Lecturer. Read her full profile here.

It’s important not to consider your LinkedIn profile as an online version of your resume. Our Best Words Career Development Instructor Daniëlla Frost recommends 7 important differences between your resume and your LinkedIn profile.

  1. Length

First of all, a resume and LinkedIn profile differ in length. Where a resume should preferably have one page and in any case no more than two, your LinkedIn profile has no maximum length. Less is more? Not on your LinkedIn profile!

2. Targeted vs. rounded view

Your resume should be a targeted document, targeted at recruiters. So how do you create targeted resumes?

You can do this by creating different resume versions that focus on different skill sets and are tailored to specific jobs. Each resume version should (at least) have a focused job title, summary and skills section.

However for your LinkedIn profile, it’s best to offer profile viewers a rounded view. You want your profile to be findable by anyone, not just by recruiters who might have a specific job for you.

3. Your Photo

My advice is not to put your photo on your resume. Employers want to be protected from allegations of discrimination and a lot of them consider including a photo is unprofessional or even inappropriate.

Adding your photo to your LinkedIn profile on the other hand, is simply a must. A profile picture builds more trust and just having a photo makes your profile 14 times more likely to be viewed by others.

4. Formatting

If you want to beat resume screening software, you should use simple formatting in your resume. That means it’s all about text and therefore best to avoid using colors, images and graphics.

On LinkedIn however, you should try to make your profile a visually attractive one. 

How? By adding a cover photo as well as media (documents, photos, videos, presentations). Also make sure you link company pages to your work experience, so that you have company logos on your profile.

5. Relevant Work Experience

On your resume, you should leave out responsibilities and achievements, and in some cases even your entire work experience, when a position isn’t relevant for the application in question.

On your LinkedIn profile it’s ‘the more the merrier’. You can include every position – including job titles, company names, dates, responsibilities and achievements. This way, you’re providing the rounded view which I discussed earlier and it will help you rank better in search results.

6. Multiple Skills

On your resume, your skills section should be a short section with up to 10 skills. Do make sure you include both hard skills (what you can do) and soft skills (how you’ll do it).

On your LinkedIn profile you can add more skills. My advice is to add up to 50 skills, which is the limit. They are great ‘social proof’ and will also increase your LinkedIn Search Engine Optimization / SEO (again!).

7. References vs. Recommendations

While you don’t have to include references in your resume, it’s great to have recommendations on your LinkedIn profile. Ask (former) customers, colleagues and employers to recommend you. 

Social proof? Check. SEO-proof? Check.

So there you have it, 7 ways your resume and LinkedIn profile should differ. I hope you can use these tips to optimize both of them!

Daniëlla Frost is Our Best Words’ Career Development Instructor. She began her career as an IT Recruiter, and she loves teaching entrepreneurs, job seekers and recruiters how to find candidates & get found on LinkedIn.

Connect with Daniëlla Frost on LinkedIn or visit her website www.sociablelift.com  

  1. Our Best Words’ expert instructors teach Technical Writing and Marketing Communication training courses for people interested in launching a great new career, working in-house or from home.
  2. At Our Best Words, we teach both theory and practical skills to make sure you understand the principles of marketing and technical communication, as well as mastering today’s most important programs, platforms, and tools.

  3. We move with the technology, offering real-time updates to former students, to make sure you stay up to date with the very latest technologies and tools.

  4. Unlike many online training courses offered, Our Best Words sessions are taught as live webinars with real-time interaction between our instructors and students, so you can ask your questions. You can also access recordings of every session, allowing you to review the materials again at your leisure.

  5. We provide expert career advice and guidance to every student and remain dedicated to your success until you’re successfully launched on the next phase of your career.

Our Best Words offers live interactive training courses that are modular and practical, taught by top industry leaders. The modules include:

  • Technical Communications Skills
  • Technical Communications Tools
  • Marketing Writing
  • Social Media Communications
  • Website Building
  • Career Development & Job Hunting

Each course module includes practical skills training, hands-on workshops, and real-world project assignments that you can use to build your personal portfolio.

To find out more about Our Best Words professional training courses, join our next Open House Webinar and meet our instructors, or contact us to discuss your career in Technical Writing or Marketing Communication.

OBW MarCom instructor Sarah Manning suggests that the rules of Search Engine Optimization have increased the value of 1,000 words. Marketing content text is today worth more than any picture!

As a content writer, I frequently have to convey complex ideas in a specific number of words – sometimes in a short headline and often in a long article. If I am working with a graphic designer on a brochure, flyer or presentation, there is often a conflict between the ideal number of words that they want to include, and the quantity of copy that I need in order to convey all the necessary information. We sometimes debate the idea that “a picture is worth a thousand words” when the designer wants to use larger pictures and cut down the text, while I maintain that pictures rarely convey the entire message.

So, let’s deconstruct this idea. A few minutes of Google research reveals that the expression was made up by an advertising executive in the 1920s. Fred R. Barnard claimed that it was an ancient Japanese proverb. How lucky we are today to have Google to help us debunk such myths!

Google is one of the reasons that a picture is no longer worth 1,000 words. If you want your online content to be found using search engines, you need more words not less. If you place your text within images, charts and info-graphics, Google will not index those words. They will not help to attract search traffic to your masterpiece. Google’s algorithm checks the quantity and quality of the text on any web page, and considers longer articles more credible and valuable than shorter pieces of text.

The Value of Words

The science of search engine optimization used to focus on how many times your keyword appeared on each page. Most SEO advice (for example, from Yoast and Search Engine Journal) recommends that a blog article should contain at least 1,000 words (and optimally 1,500 words) if you want Google to take it seriously. However, the number of words is irrelevant if the article is not well-written.

The new AI Google algorithm looks at how informative and relevant your text is, rather than how many times your keyword is mentioned. Nevertheless, it is important that the keyword phrase you have chosen to optimize each page for search appears in the heading, in the page URL, and several times within the page text. You can also please Google by varying your text to use synonyms for your keywords that Google recognizes, because that is a more natural and sophisticated way to write than repeating the same phrases multiple times.

The Value of Pictures

Of course, Google also values images. Search engine results typically include relevant images, but the Google spider usually identifies which images are relevant according to the ‘metatext’ that accompanies each image. When uploading images to the internet to accompany a story or to illustrate a page, it is crucial to optimize your pictures for search. This includes giving the photo a title that is a helpful search phrase, and adding a description and ‘alt text’, which is the text that shows up when a picture is blocked. It is also helpful to give your image a relevant name before you upload it to the website, because this cannot be changed later. Photos that are only identified by the string of numbers allocated by the camera or phone on which they were taken will remain anonymous on the internet.

Optimizing your images can help to bring searchers to your content. If the image is interesting and correctly titled and tagged, it can attract attention more quickly than the non-pictorial search engine results on the page. It helps that Google often shows relevant images in a prominent position on the search engine results page, and there is no denying that people’s eyes are drawn toward images on a page full of text.

Too Long: Didn’t Read

So, going back to our question, if you are writing copy for a brochure, flyer or presentation, graphics and images may be worth more, and your word count should be kept to a minimum. But when you are writing promotional content for the internet, words still count for more! Quality is as important as quantity, and you need to write engaging content to keep the interest of the reader who found your content.

One of my least-favorite expressions these days is TL:DR – too long, didn’t read. This dismissive expression is thought to indicate that an article was too long to be worth reading, but I think it says more about the reader! We are all pressed for time, and it is important to respect your reader, not least because there are many other things they could be doing instead of reading your content. However, as long as your long article is interesting and contains valuable information, it should contribute to their understanding of your offering and enhance the reputation of your brand. Trust the reader to decide whether your article is worth reading! Articles shared on LinkedIn are helpfully tagged with notes telling you how many minutes the article will take to read, to help surfers decide if they want to stop and click or scroll on by.

Learning Content Writing

As a copy and content writer, I always take into consideration the context and the market that I am writing for. If I am writing text for an ad campaign, the copy needs to be concise and each word carefully chosen for maximum impact. If I am writing a website or blog articles, it’s still important to write short, punchy headlines, but I also need to write plenty of clear, relevant text that explains everything that the client wants to say about their company and their products. The keyword phrase should be inserted from time to time to ensure that Google gets the message, but without ‘keyword stuffing’ or alienating the reader by repeating the same phrase multiple times in an unnatural way.

The joy of marketing writing, for me, is the opportunity to use different skills to create marketing content of different types. One day I may be crafting a promotional email, where the subject line and call to action texts are the most critical, and the next I may be writing a brochure. The same client will need an impressive summary of their activities for their website home page, and also more specific articles for their blog which convey their expertise in different aspects of their business.

The Creativity of Marcom 

I chose to become a marketing writer because I love the creativity of marketing communications. That includes choosing good images to accompany the words, and indeed the creative process sometimes starts with searching for images that will help to convey the same message as the words I need to write. In the golden age of advertising, a copywriter would work with a graphic artist to come up with the visuals and the text for an ad campaign. Today, you may be asked to do both. Marketing communications involves using words creatively and persuasively, in ways that will persuade Google and the consumer that your subject is interesting and relevant.

So, in case you are wondering what keyword phrase this article is optimized for, it isn’t! I decided that for once I would write what I wanted to say, and share thoughts that I hope will be helpful to people who are considering training for a career in marketing communications. This time, I’m not writing for Google. This time I’m writing for you!

To find out more about becoming a MarCom Writer, click here.

Read More

clip_image002

Technical writers translate complex subjects for users. They change technical jargon and turn it into understandable text for everybody. Regardless of the industry or field of expertise, there are three important tips for writing technical documentation.

Use plain English instead of complex phrases or buzz words

Every industry and market has its own buzz words. “Discussing it offline”, “working around it”, “streamlining operations”, “thinking outside the box”, “impacting the bottom line” belong in marketing materials, not in technical documentation such as user guides and manuals. Especially for tenders and RFPs and RFIs are buzz words and jargon the kiss of death – governmental agencies require that documents are easy to read and understand.

Understand the local lingo

A technical writer must understand the “local lingo” or jargon. For proper technical writing, the writer must fully understand what a certain phrase or term means to a customer and (end) users. Technology companies have the tendency to coin their own definitions. No online research will help the writer; only direct asking the source (content provider, product manager, software developer, etc.).

Recycle and reuse to avoid reinventing the wheel

Technical writing normally deals with similar documents within an organization over time. It is therefore not necessary for a technical writer to start from scratch for each project. Unless it is a nascent start-up, legacy templates, earlier technical writing documents such as reports, proposals, and user manuals are floating around in the organization. It is therefore a lot safer (and easier) to look for templates to tweak or to use as a starting point. For odd projects, there are normally examples that can be used as an outline.

These three tips will help you as a technical writer to be an asset to a team, to contribute user-friendly and customer-specific content that adds additional value to organizations.

Want to learn more about the difference between technical writing and marketing writing? Sign up for one of our courses! Email us at: info@ourbestwords.com

You can also call us at the Our Best Words Main Office: 02-656-3369
US & Canada: 1-786-507-8206

Ephraim King, CEO: 050-529-0775
Tracey Shipley, Marketing Coordinator: 054-810-8918

(Image courtesy of Susana Maria Rosende)

clip_image001One of the best ways to promote a company is with opinion articles. Many magazines (online and hard copy) welcome well-written articles. These articles should not be biased though – nobody wants to read a (blatant) sales pitch. As marketing professions will tell you – educating your target audience/potential customers is an effective marketing strategy.
Before starting to write, identify the target audience. Who are the readers of the magazine you want to send the article to? What are their interests? Do you have a direct connection to the editor, or only via a PR company? Does the magazine allow hyperlinks? Do they also want original illustrations? In short – do your homework!
Many marketing and copywriters ghostwrite – they write the opinion pieces for a company’s CEO, CMO or CTO, and when published, it will be under their name.
Points of attention when writing an opinion piece:

  1. It must be informative. The reader should learn something from reading the article.
  2. It must be interesting. The text should flow and keep the reader interested to go on reading.
  3. It must be based on facts, and not assumptions. References to recent events that were covered in the global media are a good hook, as are reports of leading analysts such as Gartner and Forrester.
  4. It must be neutral. As mentioned before, nobody wants to read a sales pitch. A neutral article covering new or future trends, or “how to…” articles are popular. At the end of the year, articles about predictions for the coming year are in demand.
  5. It should have hyperlinks (if allowed by the newspaper), footnotes and references. It makes the article trustworthy and increases the chance for publication.
  6. Most magazines will ask for illustrations. Try to have original images in high resolution. No matter what industry you are in, the chance that your competitors use the same stock photos is high. Diagrams are always popular in tech pieces, as are product photos. Make sure to send different photos to various magazines – don’t forget, they all want to have original content!
  7. Custom write your story tailored to each magazine. Sending the same article to several tech magazines is professional suicide, especially in today’s viral media.
  8. Make sure to put a short bio with contact details at the bottom of the article.
  9. Follow up. Once you see that your article in published, drop a thank-you note to the magazine (or journalist). Blog and tweet about it, and make sure to include the URL of the publication.

Immigrants who made Aliyah within the last 10 years could qualify for an 80% scholarship through the Misrad Haklita Voucher Program

Jerusalem – May 19, 2011 – Our Best Words (OBW), a Jerusalem-based company providing technical writing services and training, announced today that it opens its 4th technical & marketing writing course.

Topics include:

  • Technical Writing – writing, editing, proofreading, using graphics, online help
  • Information/Document Development – API, medical, hardware/software documentation
  • Skills – advanced use of Microsoft Word, Excel, PowerPoint, and Outlook Project and document management
  • MarCom – marketing, marketing writing, PR, social media

Since Tzfat is a hub of talented English-speaking professionals, we are opening our 4th course there to help immigrants and veterans start a new career as a technical writer,” said Ephraim King, CEO of Our Best Words. “Our program also includes an internship and assistance with employment placement.”

The course will take place on Thursdays from 9:30 till 18:30 at the Merkaz Tze’irim, 10 HaNasi St. in Tzfat.

Starting 7 July 2011, the 152-hour course consists of 8-hour sessions during 19 weeks.

The price is NIS11,000 (which includes a state-of-the art laptop with a fully licensed copy of MS Office 2010) or NIS 9,000 without a laptop. Additional discounts are available for AACI members.

Want to learn more? Contact us for an interview and placement test at:

Our Best Words Main Office: 02-656-3369
US & Canada: 1-786-507-8206

Ephraim King, CEO: 050-529-0775
Tracey Shipley, Marketing Coordinator: 054-810-8918
Email: info@ourbestwords.com
Website: http://www.technicalwriting.co.il/training/tech-writing-course-tzfat/

About Our Best Words
Our Best Words (OBW) specializes in providing quality technical communications to customers worldwide. The Company enjoys close relationships with a broad range of businesses – from startups to Fortune 500 companies. Offerings include corporate technical documentation, localization, technical communication, and technical marketing services worldwide. The Our Best Words team is comprised of experienced and dedicated professionals with years of experience in technical and marketing communications.
Visit OBS website at: www.ourbestwords.com