<?xml version="1.0" encoding="UTF-8"?> <rss
version="2.0"
xmlns:content="http://purl.org/rss/1.0/modules/content/"
xmlns:wfw="http://wellformedweb.org/CommentAPI/"
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:atom="http://www.w3.org/2005/Atom"
xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
> <channel><title>STC Europe SIG</title> <atom:link href="http://www.stc-europe.org/feed/" rel="self" type="application/rss+xml" /><link>http://www.stc-europe.org</link> <description>Society for Technical Communication&#039;s Europe SIG</description> <lastBuildDate>Mon, 23 Jan 2012 11:58:13 +0000</lastBuildDate> <language>en</language> <sy:updatePeriod>hourly</sy:updatePeriod> <sy:updateFrequency>1</sy:updateFrequency> <generator>http://wordpress.org/?v=3.3.1</generator> <item><title>Results of our recent Watercooler Webinar survey</title><link>http://www.stc-europe.org/2012/01/23/results-of-our-recent-watercooler-webinar-survey/</link> <comments>http://www.stc-europe.org/2012/01/23/results-of-our-recent-watercooler-webinar-survey/#comments</comments> <pubDate>Mon, 23 Jan 2012 11:58:13 +0000</pubDate> <dc:creator>admin</dc:creator> <category><![CDATA[SIG]]></category> <category><![CDATA[chats]]></category> <category><![CDATA[members]]></category> <category><![CDATA[webinars]]></category> <guid
isPermaLink="false">http://www.stc-europe.org/?p=631</guid> <description><![CDATA[At the end of last year we surveyed our members about our regular Watercooler Webinar chats and what topics you’d like to discuss in 2012. We had 18 respondents. Most people replied that they would prefer to discuss internationalisation and global work issues (82%) covering producing documentation for international audiences and working with teams/companies located [...]]]></description> <content:encoded><![CDATA[<p>At the end of last year we surveyed our members about our regular Watercooler Webinar chats and what topics you’d like to discuss in 2012. We had 18 respondents.</p><p>Most people replied that they would prefer to discuss internationalisation and global work issues (82%) covering producing documentation for international audiences and working with teams/companies located globally. Fewer (18%) were interested in discussing localisation and translation issues covering adapting documentation to regional needs and translation project issues.</p><h2>Top internationalisation &#038; global work topics to discuss</h2><p>The survey gave a list of five proposed topics for discussion and here are the results in order of preference:</p><ol><li>Global harmonisation of documentation standards across different writing groups in a company</li><li>Getting started in terminology management</li><li>Collecting metrics about our documents</li><li>Impact of mergers and acquisitions on documentation and writing teams, particularly if the teams are located across different countries</li><li>Making a business case to get a new tool for doing documentation</li></ol><p>Internationalisation &#038; global work topics proposed by respondents are</p><ul><li>Embedded information in globalised software</li><li>Content structure differences across languages and locales</li><li>Why tech pubs is the logical department to lead these tasks</li></ul><h2>Top localisation and translation issues topics to discuss</h2><p>The survey gave a list of four proposed topics for discussion and here are the results in order of preference:</p><ol><li>Doing more with less when translating manuals – let’s talk money.</li><li>European Union directives and their impact on documentation.</li><li>Absent best practices &#8211; Most localisation problems start with the English source documentation.</li><li>The impact can poor content and layout on localization.</li><li>Stepping into the House of Babel. What to consider when starting to get our documentation translated.</li></ol><h2>When to hold the chats</h2><p>We also asked about when you’d like to hold the chats. Most of you (44%) preferred the second week of the month to hold the chat. Wednesday was the most popular day (50%) but Tuesday and Thursday scored well too (39% each).</p><p>Two times were favoured for the chats: 16:00 CET (10:00 am EST) and 17:00 CET (11:00 am EST). Both scored 56%. Third most popular time was 18:00 CET (12:00 EST) scoring 50%.</p><h2>Our next chat</h2><p>So for 2012, we’ll be holding our Watercooler Webinar chats on Wednesdays, the second week of the month. Later in the afternoon seems the best time, either 16:00 or 17:00 CET. Over the next couple of months we’ll discuss the two top topics selected, Global harmonisation and Getting started in terminology. These results also give us good ideas for webinar presentations by invited speakers.</p><p>Our next Watercooler Webinar chat will be on Wednesday, 8 February. Details will be sent out to members shortly.</p><p>And don’t forget Alice Jane Emanuel’s <a
href="http://www.stc-europe.org/2012/01/11/webinar-31-jan-design-and-typography-for-technical-communication/">webinar on Thursday, 31 January, on documentation and typography</a>! It should be excellent.</p> ]]></content:encoded> <wfw:commentRss>http://www.stc-europe.org/2012/01/23/results-of-our-recent-watercooler-webinar-survey/feed/</wfw:commentRss> <slash:comments>0</slash:comments> </item> <item><title>Webinar 31 Jan.: Design and Typography for Technical Communication</title><link>http://www.stc-europe.org/2012/01/11/webinar-31-jan-design-and-typography-for-technical-communication/</link> <comments>http://www.stc-europe.org/2012/01/11/webinar-31-jan-design-and-typography-for-technical-communication/#comments</comments> <pubDate>Wed, 11 Jan 2012 09:30:08 +0000</pubDate> <dc:creator>admin</dc:creator> <category><![CDATA[seminar]]></category> <category><![CDATA[design]]></category> <category><![CDATA[stc france]]></category> <category><![CDATA[techcomm]]></category> <category><![CDATA[typography]]></category> <category><![CDATA[webinar]]></category> <guid
isPermaLink="false">http://www.stc-europe.org/?p=619</guid> <description><![CDATA[On Tuesday, January 31, join the STC Europe SIG and STC France Chapter for a webinar on design and typography for technical communication with STC member and quality expert, Alice Jane Emanuel. This 1-hour session will introduce you to best practices in design and typography for technical communication and will include plenty of practical advice [...]]]></description> <content:encoded><![CDATA[<p>On Tuesday, January 31, join the STC Europe SIG and <a
href="http://stcfrance.org/" rel="external">STC France Chapter</a> for a webinar on <a
href="http://hosted.verticalresponse.com/370553/474e194d38/1554000143/a0de9c07ac/" rel="external">design and typography for technical communication</a> with STC member and quality expert, Alice Jane Emanuel.</p><p>This 1-hour session will introduce you to best practices in design and typography for technical communication and will include plenty of practical advice that you can use right away to improve reader comprehension and information absorption.</p><p>Read <a
href="http://hosted.verticalresponse.com/370553/474e194d38/1554000143/a0de9c07ac/" rel="external">all the details, including registration</a> now!</p><p>This webinar is sponsored by UTC Fire &#038; Security EMEA.</p> ]]></content:encoded> <wfw:commentRss>http://www.stc-europe.org/2012/01/11/webinar-31-jan-design-and-typography-for-technical-communication/feed/</wfw:commentRss> <slash:comments>1</slash:comments> </item> <item><title>Watercooler Webinar: Collecting user feedback</title><link>http://www.stc-europe.org/2011/11/29/watercooler-webinar-collecting-user-feedback/</link> <comments>http://www.stc-europe.org/2011/11/29/watercooler-webinar-collecting-user-feedback/#comments</comments> <pubDate>Tue, 29 Nov 2011 09:35:03 +0000</pubDate> <dc:creator>admin</dc:creator> <category><![CDATA[SIG]]></category> <category><![CDATA[customers]]></category> <category><![CDATA[feedback]]></category> <category><![CDATA[forms]]></category> <category><![CDATA[multilingual]]></category> <category><![CDATA[questionnaire]]></category> <category><![CDATA[surveys]]></category> <guid
isPermaLink="false">http://www.stc-europe.org/?p=606</guid> <description><![CDATA[by Jen O Neill In this month’s Watercooler Webinar held by the Europe SIG, we discussed the various ways we can collect feedback from the global users of the products we document. Many of us write for audiences located across countries and languages. How do we find out if our documentation meets their needs when [...]]]></description> <content:encoded><![CDATA[<p><em>by Jen O Neill</em></p><p>In this month’s Watercooler Webinar held by the Europe SIG, we discussed the various ways we can collect feedback from the global users of the products we document. Many of us write for audiences located across countries and languages. How do we find out if our documentation meets their needs when due to geography, language or cost factors, it often isn’t practical for us to meet them directly?</p><p>In our chat, we discussed the different ways to collect information from users. It was interesting to hear real examples of how people have done it.</p><h3>Contacting technical support</h3><p>An obvious source of customer information is speaking with technical support and product management. They can be a mine of information about customers and the problems they’re reporting. Some companies, such as HP, keep knowledge databases of calls received by technical support and the solutions provided. Such databases can then be searched for problems encountered by users. Even smaller companies will have a log of issues brought up by customers.</p><p>One tool that we all seemed to have used at one stage in our quest for user feedback was forms. A well designed form is crucial and care is needed to prepare the questions so that you collect useful and correct information. A book recommendation was “<a
href="http://www.formsthatwork.com/">Forms that Work: Designing Web Forms for Usability</a>” by Caroline Jarrett and Gerry Gaffney.</p><p>Two useful points brought up were that it’s a good idea to offer a prize or small gift to those who take part in surveys as a way of saying thanks. Often this can simply be to send the results of the survey to respondents. Another point was if you are collecting feedback via email, you should use an email alias address instead that of a person.</p><p>One source of documentation feedback that writers may not consider is that from translators. We had a translator in the discussion who described that translators often pick up inconsistencies and errors in texts and terminology and will seek to ask writers for clarification.</p><p>Interestingly, none of us worked for companies that used social media such as Facebook or Twitter to collect information from customers.</p><h3>Customer surveys</h3><p>An example of a customer survey that we discussed was one my company did a few years ago. The European technical writers had to do projects as part of their Six Sigma Green Belt certification to improve documentation quality. We used a multilingual Web survey to collect feedback from customers about our documentation.</p><p>We drew up a 10-question online questionnaire covering satisfaction, usefulness of the manuals and problems encountered across three product groups. Questions had five-point scales for answering with one open-ended question. We did the questionnaire in seven languages including English as most of our customers don’t work in English. As we each managed the localisation of our own projects, we knew the technical support people in the sales offices across Europe. They were the in-country reviewers for translations. So we asked them to help us translate the questionnaire and any associated texts.</p><p>The seven language versions of the survey were located on the European HQ web site. We got the agreement from the country sales managers in seven countries to have information on their national web sites about the survey that linked to the HQ site with the multilingual questionnaires. Two of the country managers did a mailing to all their customers to encourage them to take part in the survey. The survey ran for a month and we got nearly 200 participants, most from the countries that did the mailings to customers (next time we will push hard to get all country offices to do mailings to customers about the survey). Respondents didn’t receive a prize or gift for taking part nor get a copy of the results. However, the sales offices did get to see the results.</p><p>We found that doing a multilingual survey took more effort than if it had just been one language; there were more steps to organise due to the need to get translations of the questionnaire, web page text and answers, as well as seeking the OK from the sales office managers. But we didn’t have any problems getting the support of our colleagues located in the sales offices located around Europe. They were also interested. However, analysing and writing up the data took time as it had to be done on top of the daily workload. We hadn’t allocated enough scheduled time to this task so it took longer than originally planned.</p><h3>Meeting customers at trade/training meetings</h3><p>Another participant, Karen Mardahl, described how she collected feedback from customers by attending a global meeting run by her company for their partners and distributors. This was the first time that such a meeting had been held in several years and attendees came from many countries. It was also the first time Karen got to meet readers of the documentation face to face. The company did a questionnaire to collect information from the attendees on many topics, and Karen got them to include one question dealing with documentation.</p><p>Based on the information collected during the meeting, the company now does a weekly newsletter to connect with their partners. A single topic is discussed in each newsletter, and feedback and questions on any product and service are very welcome. The newsletter is encouraging them to get in touch with the company with their issues.</p><h3>The next Watercooler Webinar</h3><p>It’s always interesting to meet with fellow professionals and compare notes, to catch up with what’s been happening at work and see how it applies to what we’re doing. This month’s Watercooler Webinar let us discuss the practicalities of collecting user feedback. The webinar is free to SIG members and you can phone in from almost anywhere in the world using the list of phone numbers provided. Come and join us in January for our next webinar! Watch our discussion list for details.</p> ]]></content:encoded> <wfw:commentRss>http://www.stc-europe.org/2011/11/29/watercooler-webinar-collecting-user-feedback/feed/</wfw:commentRss> <slash:comments>0</slash:comments> </item> <item><title>Double Dutch: Writing addresses</title><link>http://www.stc-europe.org/2011/11/08/double-dutch-writing-addresses/</link> <comments>http://www.stc-europe.org/2011/11/08/double-dutch-writing-addresses/#comments</comments> <pubDate>Tue, 08 Nov 2011 08:38:30 +0000</pubDate> <dc:creator>admin</dc:creator> <category><![CDATA[Tips and Tricks]]></category> <category><![CDATA[addresses]]></category> <category><![CDATA[formats]]></category> <category><![CDATA[postal codes]]></category> <category><![CDATA[spelling]]></category> <guid
isPermaLink="false">http://www.stc-europe.org/?p=601</guid> <description><![CDATA[by Jen O Neill When writing a Dutch address in English, which country name format do you use: Netherlands or The Netherlands? Both work. Indeed on some English-language web sites you may even see both formats used. I admit I have always used the “The Netherlands” format in addresses, as do many people. The Dutch [...]]]></description> <content:encoded><![CDATA[<p><em>by Jen O Neill</em></p><p>When writing a Dutch address in English, which country name format do you use: Netherlands or The Netherlands?</p><p>Both work. Indeed on some English-language web sites you may even see both formats used.</p><p>I admit I have always used the “The Netherlands” format in addresses, as do many people. The Dutch themselves, when writing their country name in English in addresses, also tend to use “The Netherlands”. For example, the Taalunie, the Dutch language body, uses this format in its English address <a
href="http://taalunieversum.org/en/contact_us/" rel="external">as shown on their contact page</a>.</p><p>Officially the post office format is “Netherlands”. Try using this <a
href="http://www.bitboost.com/ref/international-address-formats.html" rel="external">list of postal formats for writing country names in addresses</a>.</p><p>In English, and several other languages, we use the plural form of the country name, the Netherlands, but in Dutch they now use the singular form, Nederland. However, in the official name of the country, Kingdom of the Netherlands (Koninkrijk der Nederlanden), they still use the plural.</p><p>The Netherlands isn’t the only country with “the” as a prefix to its name. Ukraine during the Soviet era was always known in English as “the Ukraine”.  However, it is now more frequent to use the name when writing it in text without “the”. On the other hand, a former colonial territory in Africa once known as Gambia now insists since its independence on being called The Gambia.</p><p>Did you know that not all countries use postal codes (also known as zip codes)? Around 70 countries in the Universal Postal Union (190 members) don’t use postal codes, including Ireland and Panama (see http://en.wikipedia.org/wiki/Postal_code). Ireland is currently planning on introducing postal codes. My sister lives in the Irish countryside and currently doesn’t have a single number in her address. Post arrives punctually.</p><p>You will also sometimes see the ISO 2-letter country code (ISO 3166-1) prefixed to a country’s postal code (for example, NL-7900). This practice is more frequently seen in continental Europe for international mail.</p><p>Addressing an envelope can be enough to drive one to a glass of whiskey. Except that whiskey itself has its own flavours of spelling. To the surprise of many people “whiskey” doesn’t follow standard UK/US English spelling rules. Its spelling depends on its country of origin. Scottish and Canadian whisky. Irish and American whiskey (visit any shop selling the drink for confirmation). “Scottish whiskey” is a serious ouch!</p><p>(Note: The author of this article is Irish, so of course “whiskey” has an “e”.)</p> ]]></content:encoded> <wfw:commentRss>http://www.stc-europe.org/2011/11/08/double-dutch-writing-addresses/feed/</wfw:commentRss> <slash:comments>0</slash:comments> </item> <item><title>Glossing over our glossaries</title><link>http://www.stc-europe.org/2011/10/03/glossing-over-our-glossaries/</link> <comments>http://www.stc-europe.org/2011/10/03/glossing-over-our-glossaries/#comments</comments> <pubDate>Mon, 03 Oct 2011 07:15:52 +0000</pubDate> <dc:creator>admin</dc:creator> <category><![CDATA[Documentation]]></category> <category><![CDATA[consistency]]></category> <category><![CDATA[sdl]]></category> <category><![CDATA[survey]]></category> <category><![CDATA[terminology management]]></category> <category><![CDATA[terminology. glossaries]]></category> <category><![CDATA[terms]]></category> <category><![CDATA[writers]]></category> <guid
isPermaLink="false">http://www.stc-europe.org/?p=591</guid> <description><![CDATA[by Jen O Neill We’re increasingly hearing about how important it is for us to manage our terminology as it impacts documentation quality, translation cost, branding and customer satisfaction. It’s no secret that most terminology problems start in the source content. Unfortunately the inconsistent use of terms in user interfaces, online and printed documentation, marketing [...]]]></description> <content:encoded><![CDATA[<p><em>by Jen O Neill</em></p><p>We’re increasingly hearing about how important it is for us to manage our terminology as it impacts documentation quality, translation cost, branding and customer satisfaction.</p><p>It’s no secret that most terminology problems start in the source content. Unfortunately the inconsistent use of terms in user interfaces, online and printed documentation, marketing material and web content often only comes to light during the translation when it can be too late or too expensive to fix.</p><h2>Glossaries used by writers are often inadequate</h2><p>Although we all probably use company glossaries or style guides to help us use terms correctly and consistently in our work, the glossaries often represent only a fraction of the terms we actually use in our work.</p><p>A clue that our glossaries may not be comprehensive enough can often come from the translators (our customers may also be having problems with our terms, but we’re rarely in contact with them).</p><p>Translators often complain that those responsible for creating the source content don’t document enough terms. They may receive a glossary from us with only a couple hundred terms or less to help them with their work. According to the terminologist, Barbara Inge Karsch, content creators document only around 20% of the terms needed by translators.<br
/> Also see <a
href="http://www.stc-europe.org/2010/06/02/a-recent-survey-on-terminology- management/" rel="external">our post on the SDL terminology survey last year</a>.</p><p>For example, in my company we found out at the translation stage that we had five different ways of saying “power up” in our English manuals:</p><p
style="text-align: center;">Power up, power on, energize, activate, start</p><p>However, only one of these terms, “power up”, was included in our glossary. The other four were unapproved undocumented terms that had all been used (several times) at some stage by writers. Perhaps when reusing existing content from different products or by a contract writer new to our products.</p><h2>How many terms should we document?</h2><p>It depends. It depends on the size of your project, the complexity of the products being documented, number of terms already documented, your budget and resources.</p><p>Barbara Inge Karsch has a good discussion on selecting terms in her blog post <a
href="http://<br /> bikterminology.com/2010/12/17/each-time-a-new-project-is-kicked-off-this-question-is-on-<br
/> the-table-content-publishers-ask-how-much-are-we-expected-to-document-localizers-ask-<br
/> how-many-new-terms-will-be-used" rel="external"</a>&#8220;How many terms do we need to document?&#8221;</a></p><p>However, few companies can afford the services of a dedicated terminologist. Indeed smaller companies may not even have an editor to help ensure that terms are correctly used by writers.</p><p>As technical writers we have to stop pretending that terminology is a “translation problem”.</p><p>We’re implicated as creators of the source content. We need to ensure that we develop comprehensive glossaries at the start of a project. This will free developers, writers, and ultimately translators, from spending time researching the terms themselves and potentially coming up with multiple terms for the same feature, which then go undetected throughout the product life cycle and can impact usability and incur extra costs.</p><h2>Heading towards terminology management</h2><p>Ideally we shouldn’t be keeping our terminology in a style guide or spreadsheet as they can eventually become too inflexible. Unfortunately terminology management tools are still expensive. For many of us, particularly if we’re lone writers or work for a smaller company, they may not yet be an affordable option. This is why Microsoft Excel is so widely used in the tech communication environment to manage glossaries. Everyone has it.</p><p>So spreadsheet tools are useful to help start us managing our terminology as they let us collect the terms we work with. And that’s the challenge, collecting the terms. Developing and maintaining a comprehensive glossary is hard work. But the sooner it is done in the documentation process, the better.</p><p>As Barbara Inge Karsch says,“As terminology management becomes more accessible and as needs for terminology data become more important, it is up to content creators and LSPs [localisation service suppliers] to learn more about this area and to find ways to consider terminology requirements earlier on in the document creation process.”</p> ]]></content:encoded> <wfw:commentRss>http://www.stc-europe.org/2011/10/03/glossing-over-our-glossaries/feed/</wfw:commentRss> <slash:comments>1</slash:comments> </item> <item><title>Working with OEM documentation</title><link>http://www.stc-europe.org/2011/07/11/working-with-oem-documentation/</link> <comments>http://www.stc-europe.org/2011/07/11/working-with-oem-documentation/#comments</comments> <pubDate>Mon, 11 Jul 2011 15:00:11 +0000</pubDate> <dc:creator>admin</dc:creator> <category><![CDATA[Work]]></category> <category><![CDATA[contracts]]></category> <category><![CDATA[glossary]]></category> <category><![CDATA[legal]]></category> <category><![CDATA[localisation]]></category> <category><![CDATA[localization]]></category> <category><![CDATA[manufacturing]]></category> <category><![CDATA[ODM]]></category> <category><![CDATA[OEM]]></category> <category><![CDATA[outsourcing]]></category> <category><![CDATA[terminology]]></category> <guid
isPermaLink="false">http://www.stc-europe.org/?p=585</guid> <description><![CDATA[by Jen O Neill Outsourcing manufacturing is big business. Many companies today use the services of other companies to make, even design, some of their products as it can provide them with needed components or products without owning and operating a factory to do this work themselves. The benefits are cost savings, improving time to [...]]]></description> <content:encoded><![CDATA[<p><em>by Jen O Neill</em></p><p>Outsourcing manufacturing is big business. Many companies today use the services of other companies to make, even design, some of their products as it can provide them with needed components or products without owning and operating a factory to do this work themselves. The benefits are cost savings, improving time to market, and access to a wider range of products than they could develop themselves in-house. Both hardware and software are outsourced.</p><h2>What’s an OEM?</h2><p>Companies to whom manufacturing is outsourced are called Original Equipment Manufacturers (OEMs). An OEM is a company that &#8220;manufactures goods that are sold to other businesses that might rebrand them and sell them at retail&#8221;. <a
href="http://www.collabis.com/glossary.html#O" rel="external">Source of OEM definition</a>.)</p><p>An Original Design Manufacturer (ODM) is a company that “designs and manufactures a product which is specified and eventually branded by another firm for sale&#8221;. (<a
href="http://en.wikipedia.org/wiki/Original_design_manufacturer" rel="external">Source of ODM definition</a>.)</p><p>OEM and ODM products are used in many industries, but particularly so in electronics. These companies are located around the world but many are based in Asia. In this article “OEM” has been used to cover both OEM and ODM companies.</p><h2>The OEM source files</h2><p>If you are rebranding or rewriting OEM documentation, be aware that in the world of OEMs, Microsoft Word rules. As cost control is a big issue with many OEMs, few have technical writers in-house but instead get their engineers to write the documentation. They use Word.<br
/> And often they’re not writing in their mother tongue – most OEMs aren’t located in English-speaking countries. The documentation consequently can often be poorly written and riddled with an “English” contaminated by another language.</p><p>Rewriting OEM manuals can be challenging, particularly if you’re working to a tight deadline and the English is poor. If your company works with many OEM products, a further challenge is trying to keep the rewritten manual consistent with the content of the other manuals in your company. Reuse of content is particularly important to help control translation costs. Yet writing for reuse can at times feel a challenge when you’re struggling with reading to comprehend, particularly if you don’t have access to the OEM engineers to ask what they meant in the text they wrote.</p><p>Some companies just simply rebrand an OEM manual and leave the content as is. There are unfortunately many examples of such manuals on the internet. Lots of companies don’t have the services of technical writers. And don’t consider the business benefits of having them either.</p><h2>Keeping terminology correct and consistent</h2><p>Working with OEM software and documentation increases the need for terminology control as there’s a greater chance of unapproved, inconsistent, and incorrect terms being present than when content is developed in-house. Even when correct, terms may also not always be the same between companies.</p><p>Build a glossary of terms related to your OEM documentation and software that includes both the correct and incorrect terms. Include context of use, the definition of the term. So next time a writer in your group is working on an OEM manual and they come across “appearance time”, for example, they can quickly look it up in the glossary and see that this must be changed to “display time”. As with all glossaries, this is a living document and must be regularly maintained.</p><p>Fluency in other languages is certainly a help when working with OEM documentation as it can make it easier to spot problems with terminology. One example we had of “flavoured” English was in the software of a French ODM we used to develop a program for us. They used the term &#8220;equipments&#8221; throughout the English source software. We changed this franglais (English with French influence) term to &#8220;devices&#8221;. The word &#8220;equipment&#8221; exists in both languages but the context of use can differ. In French this is called a &#8220;faux amis&#8221; or &#8220;false cognate&#8221; in English.  Be continually on the lookout for such faux amis when checking software and documents written by OEMs.</p><p>Where possible, give the OEM your company’s glossary of approved terms to use when customizing products for your company. But continually check that your company’s approved terms are indeed being used, particularly when the product is updated. A different engineering team perhaps might be put in charge of the product update and for whatever reason they could ignore or overlook your glossary. Stay alert.</p><h2>Legal issues</h2><p>Reuse as is or rewrite the OEM documentation? This question will be answered in the contractual agreement drawn up between the OEM and the company using their services. It will specify whether the product documentation will be handed over by the OEM to be customized. So if you have any specific documentation needs, such as you want to the source files in XML, FrameMaker, or HTML, for example, you should ensure that this is agreed upon before any contractual agreement is signed. But as stated earlier, most OEMS work in Word.</p><p>In my experience, many OEM manuals have incomplete or no regulatory information included, where required. If you are rebranding/rewriting OEM manuals, check that all required legal information is indeed included for your market. Although legally the manufacturer is responsible for placing the CE mark on the product, for example, once you rebrand it, you then become legally responsible. See an earlier blog on <a
href="http://www.stc-europe.org/2010/10/04/sharing-our-source-files-with-other-companies/" rel="external">sharing source files with third party companies</a>.</p><h2>Localisation issues</h2><p>In my experience, few OEM companies consider the impact of localization on their software and documentation even if they are selling their products worldwide. And that includes OEMs with in-house technical writers.</p><p>If you will be translating the documentation you’ve inherited from an OEM, you should review it for potential localization issues such as embedded text in graphics (do you have the source graphic files or just the jpeg files?), terminology (mentioned earlier), and possible cultural issues in the content. One OEM my company worked with had in-house native English-language technical writers who targeted their documentation to the America market although the OEM sold its products in many other countries. They had, for example, used the term “Thanksgiving” in a section of a user manual on programming schedules instead of the generic “public holiday”. We had to carefully go through their manuals to ensure that the content was culturally neutral for our market in Europe, Middle East, and Africa.</p><h2>In summary</h2><ul><li>From the contractual agreement and your product managers, find out what has been agreed with the OEM with regards to the documentation.</li><li>Develop a glossary specific for this OEM (or expand your group’s glossary) that includes correct and incorrect terms.</li><li>Check that the legal information in your rebranded/rewritten documentation is correct and complete.</li><li>If you translate, check for potential localization issues.</li></ul> ]]></content:encoded> <wfw:commentRss>http://www.stc-europe.org/2011/07/11/working-with-oem-documentation/feed/</wfw:commentRss> <slash:comments>0</slash:comments> </item> <item><title>STC Pushes to Become More International in Outlook</title><link>http://www.stc-europe.org/2011/06/13/stc-pushes-to-become-more-international-in-outlook/</link> <comments>http://www.stc-europe.org/2011/06/13/stc-pushes-to-become-more-international-in-outlook/#comments</comments> <pubDate>Mon, 13 Jun 2011 19:24:30 +0000</pubDate> <dc:creator>admin</dc:creator> <category><![CDATA[STC]]></category> <category><![CDATA[communication]]></category> <category><![CDATA[GATF]]></category> <category><![CDATA[global issues]]></category> <category><![CDATA[globalisation]]></category> <category><![CDATA[globalization]]></category> <category><![CDATA[internationalisation]]></category> <category><![CDATA[internationalization]]></category> <category><![CDATA[society for technical communication]]></category> <guid
isPermaLink="false">http://www.stc-europe.org/?p=567</guid> <description><![CDATA[by Jen O Neill The Society for Technical Communication (STC) is one of the world’s largest organisations for technical communication. We have members across the world. Currently around 18% of STC members are based outside of the United States, most in Canada. Around 5% of members are in Europe and Asia. So perhaps it shouldn’t [...]]]></description> <content:encoded><![CDATA[<p><em>by Jen O Neill</em></p><p><a
href="http://stc.org/" rel="external">The Society for Technical Communication (STC)</a> is one of the world’s largest organisations for technical communication. We have members across the world. Currently around 18% of STC members are based outside of the United States, most in Canada. Around 5% of members are in Europe and Asia. So perhaps it shouldn’t be too surprising if it can have a very US-centric focus as most members are there.</p><p>But it is surprising. And frustrating.</p><p>Our business is communication and an increasing number of us work globally. Even if we may not travel as part of our jobs or be based in a foreign country, our work could well be used in multiple countries and languages.</p><p>Being global in outlook matters. Understanding how “global” impacts our work and jobs is important so that we can then better meet customer and colleague needs wherever they may be based. It also means we are better able to professionally evolve to changing market demands. As an international professional organisation, STC should be there helping us irrespective of where we’re based.</p><h2>Problems faced by members based outside of the US</h2><p>Non US-based members have been complaining for several years to the STC board about the lack of a real global outlook from headquarters and how poorly non US-based members are often served. Examples of current issues are</p><ul><li>Some membership benefits only available to US members</li><li>Cost of webinars</li><li>Can only pay using credit cards (EFT – electronic funds transfer &#8211; still not available)</li><li>Lack of regional conferences and workshops</li><li>Poor communication between headquarters and members</li><li>Lack of in-depth sessions on localisation/internationalisation at conferences</li><li>And the lack of globalized content in the Society Web site, communications and forms (such as dates, times, addresses)</li></ul><p>Responding to our requests for change, in 2006 the STC board set up a committee to review how the society could better meet the needs of its international members. This Global Strategies committee advised the office and board on many globalisation issues. A globalisation audit of the society unfortunately had to be postponed in 2008 due to the financial crisis.</p><h2>So how are we doing with globalising the society?</h2><p>A year ago, the Globalisation Audit Task Force (GATF) was set up to determine how the society could improve communication with non US-based members and determine issues that needed to be resolved.<br
/> Over the past year GATF has collected a list of globalisation issues from multiple sources within in the STC such as our forums and conversations with members as well as reviewing the old website. They also interviewed non US-based members on their needs. All this work provides an insight into the problems faced by members based around the world and gives an informative update on where the STC is in its progress on becoming a more globalised organisation, better able to meet the needs of a multi-cultural membership working in a world that gets smaller every day.</p><p>The <a
href="http://www.stc-europe.org/wp-content/uploads/STC_GATF_report_final_13May2011.pdf" rel="external">2011 GATF report</a> and the <a
href="http://www.stc-europe.org/wp-content/uploads/STC GATF slides_14May2011.pdf" rel="external">presentation of the GATF report to the STC Board</a> at the 2011 annual conference last May make interesting reading. I strongly encourage you to read them.</p><h2>Where do we go from here?</h2><p>Progress on improving the international outlook of the society has been slow so this work by GATF is a good step forward. The report gives a practical list of action items and advises that the society how it could proceed.</p><p>From this list, we  see that there are several things we could all do individually and collectively to push global issues:</p><ul><li><strong>Educate members on globalisation:</strong> Write articles and blogs on STC sites (including the Europe SIG). If you have experience in globalisation, seriously consider submitting a proposal to the annual conference that’s aimed at other experienced members.</li><li><strong>Make webinars more available to different time zones:</strong> Run webinars ourselves to make them more accessible to members in different time zones. However, running a webinar using the facilities used by STC headquarters, Genesys, is too expensive when based outside of North America. Fortunately, there are many other tools around that are more affordable. We could compare notes with other regional groups on suitable webinar tools. Seek sponsorship to make them more affordable.</li><li><strong>Planning regional conferences</strong> (and with volunteers) is hard work (I’ve helped with a few and can speak from experience) so they won’t be annual events. Local initiative gets these off the ground. They don’t have to be large events. Perhaps partner with another international or national association on a shared theme?</li></ul><p>Clearly change won’t happen overnight but we need to ensure that the board and office don’t just sit back and do little to solve this growing need. So this is where we all come into the equation. A small committee can only push so hard. We should now all help push the society to become the international society that so many of us want (and expect).</p><p>What ideas do you have for pushing these changes forward?<br
/> What suitable and affordable webinar tools can you recommend?<br
/> Are there issues not covered in the GATF report?</p><p>Share your thoughts and ideas in the comments.</p> ]]></content:encoded> <wfw:commentRss>http://www.stc-europe.org/2011/06/13/stc-pushes-to-become-more-international-in-outlook/feed/</wfw:commentRss> <slash:comments>3</slash:comments> </item> <item><title>What’s the most important time zone in Europe?</title><link>http://www.stc-europe.org/2011/05/23/what%e2%80%99s-the-most-important-time-zone-in-europe/</link> <comments>http://www.stc-europe.org/2011/05/23/what%e2%80%99s-the-most-important-time-zone-in-europe/#comments</comments> <pubDate>Mon, 23 May 2011 09:00:14 +0000</pubDate> <dc:creator>admin</dc:creator> <category><![CDATA[Work]]></category> <category><![CDATA[collaboration]]></category> <category><![CDATA[culture]]></category> <category><![CDATA[customs]]></category> <category><![CDATA[geography]]></category> <category><![CDATA[time]]></category> <category><![CDATA[time zones]]></category> <guid
isPermaLink="false">http://www.stc-europe.org/?p=561</guid> <description><![CDATA[by Jen O Neill Working for an American multinational company with technical writing colleagues on both coasts of the US and me in Belgium, you’d think I’d be watching the clock to see when they’re in the office so that we can talk. Nope. I’m not watching the Instant Messager screen on my computer to [...]]]></description> <content:encoded><![CDATA[<p><em>by Jen O Neill</em></p><p>Working for an American multinational company with technical writing colleagues on both coasts of the US and me in Belgium, you’d think I’d be watching the clock to see when they’re in the office so that we can talk.</p><p>Nope.</p><p>I’m not watching the Instant Messager screen on my computer to see who’s available in the US. It’s my colleagues across Europe that I’m tracking. I often need them at short notice for information.<br
/> So which time zone matters the most to me when trying to get hold of my European colleagues during the day?</p><p>Lunchtime!</p><p>Between time zone differences and cultural differences on when to eat that exist between European countries sometimes I sometimes feel that I’ve been thinking about lunch for much of the day. If it’s X time, then A must be at lunch. And at X+1 time, B and C will be at lunch. C is at lunch at X+2 time …</p><p>From 11:00 in the morning (my time) my Finish colleagues aren’t around. It’s noon for them and they’re at lunch so no point chasing Finns then. An hour later, it’s my lunch time. So the German, French, Dutch and Italian colleagues know they won’t have me pinging them as we’re all at lunch.</p><p>By 14:00, my time, there’s no point contacting colleagues in Britain for information as it’s 1pm for them and they’re gone to lunch (except they’re not gone for long). In the past my Spanish colleagues would be off to lunch at 14:00 and often not return until near 16:00. So for a few years I was tracking a lunch time zone that could last up to five hours yet I never left Europe.</p><p>For many of us in Europe lunch is a main meal and not a grab-n-gobble sandwich at our desks. Sadly the two-hour lunch no longer (officially) exists in our European offices. When I moved to France from Britain years ago, I quickly adapted to a slow two-hour lunch with colleagues. The company canteen served a five-course meal with wine or beer. I then moved to Belgium to work for another company and lunch became an hour. Only one hour!</p><p>Working in a corporate environment can mean that local habits change. I can’t remember when the two-hour lunch disappeared in our French office but when we were bought by our current owner, they insisted that the Spanish office fall into line with the rest of the offices in Europe. They had to eat earlier and come back in an hour. They weren’t happy about that. These days I can ping Spain at 14:00 and get a reply.</p><p>My lunch time zone now at work is only around three hours.</p><p>Bon appetite!  (Now if you could just get that info back to me by…and pass the salt. Thanks)</p> ]]></content:encoded> <wfw:commentRss>http://www.stc-europe.org/2011/05/23/what%e2%80%99s-the-most-important-time-zone-in-europe/feed/</wfw:commentRss> <slash:comments>0</slash:comments> </item> <item><title>Getting Reviews from SMEs</title><link>http://www.stc-europe.org/2011/04/20/getting-reviews-from-smes/</link> <comments>http://www.stc-europe.org/2011/04/20/getting-reviews-from-smes/#comments</comments> <pubDate>Wed, 20 Apr 2011 20:28:35 +0000</pubDate> <dc:creator>admin</dc:creator> <category><![CDATA[Tips and Tricks]]></category> <category><![CDATA[fun]]></category> <category><![CDATA[humor]]></category> <category><![CDATA[humour]]></category> <category><![CDATA[reviews]]></category> <category><![CDATA[technical writers]]></category> <guid
isPermaLink="false">http://www.stc-europe.org/?p=551</guid> <description><![CDATA[by Jennifer O Neill HONORABLE COLLEAGUE, WE ARE THE TECHNICAL WRITERS. YOU WERE RECOMMENDED BY AN ASSOCIATE WHO ASSURED US IN CONFIDENCE OF YOUR ABILITY AND RELIABILITY TO CARRY OUT PENDING REVIEWS IN GREAT MAGNITUDE WITHOUT RAISING ANY MISGIVING ATTITUDE. CONSEQUENTLY WE HAD THE COURAGE TO CRAVE AN INDULGENCE FOR THIS IMPORTANT BUSINESS FOR CHECKING [...]]]></description> <content:encoded><![CDATA[<p><em>by Jennifer O Neill <img
src='http://www.stc-europe.org/wp-includes/images/smilies/icon_smile.gif' alt=':-)' class='wp-smiley' /> </em></p><p>HONORABLE COLLEAGUE,</p><p>WE ARE THE TECHNICAL WRITERS. YOU WERE RECOMMENDED BY AN ASSOCIATE WHO ASSURED US IN CONFIDENCE OF YOUR ABILITY AND RELIABILITY TO CARRY OUT PENDING REVIEWS IN GREAT MAGNITUDE WITHOUT RAISING ANY MISGIVING ATTITUDE.</p><p>CONSEQUENTLY WE HAD THE COURAGE TO CRAVE AN INDULGENCE FOR THIS IMPORTANT BUSINESS FOR CHECKING MANUALS BELIEVING THAT YOU WOULD NEVER LET US DOWN EITHER NOW OR IN THE FUTURE. UNFORTUNATELY THE INFORMATION DEPT. OF ARCHITECTURED CONTENT IS REGRETFUL THAT INVESTIGATIONS ON THE EDIT MODIFICATIONS BY YOU RECEIVED TO US DO NOT ALWAYS ASSIST THE DOCUMENT. FURTHERMORE, YOUR URGENT ASSISTANCE OCCASIONALLY LACKS URGENCY. THE OWNERS OF THE DOCUMENTS YOU RECEIVE FROM US ARE NOT DIED &#8211; WE MOST GRACIOUSLY SEEK THE DOCUMENTS BACK FROM YOU WITHIN THE GIVEN GENEROUS 2-DAY PERIOD OF REVIEW.</p><p>WE WANT TO CONTINUE TO TRANSFER DOCUMENTS FOR REVIEW BECAUSE OF THE NEED TO INVOLVE YOU AS AN EXPERT MATTER WORKER WHO CAN APPROVE THE NOBLE CONTENTS. HOWEVER, WE REQUIRE CO-OPERATION THAT FUTURE TRANSACTIONS BETWEEN US COMPLY WITH OUR STYLE STANDARDS AND TIME SCALE.</p><p>WE NOW APPROACH YOU WITH INSTRUCTIONS THAT WILL BE OF IMMENSE BENEFIT TO BOTH OF US. PLEASE FOLLOW THE ENCLOSED INSTRUCTIONS CAREFULLY.</p><p>FURTHERMORE PLEASE IMMEDIATELY SEND US YOUR BANK ACCOUNT DETAILS FOR WHEN WE MAY TO NEED TO ACCESS YOUR ACCOUNT TO IMPOSE AN EDUCATION FINE ON UNURGENCY OR STYLISTIC REWRITING. WE ALREADY HAVE YOUR WORK TELEPHONE NUMBER AND EMAIL. DO NOT BE CONCERNED ABOUT CURRENCIES. WE TAKE EVERYTHING.</p><p>THANKING YOU FOR YOUR ANTICIPATED COOPERATION.</p><p>YOURS MOST TRULY,</p><p>TECHNICAL WRITER</p><p>INSTRUCTIONS FOR REVIEW OF MANUAL BY EXPERT MATTER PERSON:</p><p>1. WE HONOURABLY SEEK YOUR ASSISTANCE WHEN REVIEWING NOBLE DOCUMENT. YOUR UTMOST SENSE OF PURPOSE IS REQUIRED. MOST KINDLY REFRAIN FROM DOING MULTIPLE OTHER TASKS AT SAME TIME.</p><p>2. IT IS UNPERMITTED TO REWRITE THE REVIEW DOCUMENT. REWRITES OF PARAGRAPHS THAT AGITATE EDITOR WILL BE CHARGED AT $30 PER PARAGRAPH.</p><p>3.  URGENT ASSISTENCE IS MOST KINDLY REQUESTED TO RETURN REVIEWS AS SPECIFIED IN INSTRUCTED DEADLINE. REVIEWS RECEIVED AFTER 19.00PM ON DEADLINE DAY SHALL INCUR LATE FINE OF $20 PER DAY LATE. LATE RETURNS BEYOND ONE MONTH SHALL INCUR $800 MONTHLY CHARGE PER DOCUMENT. IMPACT IF NEVER RETURN OR LOST DOCUMENT SHALL BE FINE OF $1000 AFTER 3 MONTHS. PERTISTENT UNURGENT RESPONSE WILL RESULT IN YOUR PHONE NUMBER ON RELEASED DOCUMENT COVER TO FACILITATE FRIENDLINESS TO END USER.</p> ]]></content:encoded> <wfw:commentRss>http://www.stc-europe.org/2011/04/20/getting-reviews-from-smes/feed/</wfw:commentRss> <slash:comments>2</slash:comments> </item> <item><title>Webinar: Measure the Quality of your Documentation, 22 March</title><link>http://www.stc-europe.org/2011/03/13/webinar-measure-the-quality-of-your-documentation-22-march/</link> <comments>http://www.stc-europe.org/2011/03/13/webinar-measure-the-quality-of-your-documentation-22-march/#comments</comments> <pubDate>Sun, 13 Mar 2011 16:57:05 +0000</pubDate> <dc:creator>admin</dc:creator> <category><![CDATA[seminar]]></category> <category><![CDATA[SIG]]></category> <category><![CDATA[documentation]]></category> <category><![CDATA[quality]]></category> <category><![CDATA[webinar]]></category> <guid
isPermaLink="false">http://www.stc-europe.org/?p=545</guid> <description><![CDATA[The STC Europe SIG and STC France chapter are pleased to present a joint webinar to the technical communication community on 22 March at 19.00 CET. Quality-assessment expert and STC member, Alice Jane Emanuel, will introduce an easy-to-use, yet comprehensive tool for document quality assessment. Alice Jane will demonstrate how this tool provides granular feedback [...]]]></description> <content:encoded><![CDATA[<p>The STC Europe SIG and <a
href="http://stcfrance.org/" rel="external">STC France chapter</a> are pleased to present a joint webinar to the technical communication community on 22 March at 19.00 CET.</p><p>Quality-assessment expert and STC member, Alice Jane Emanuel, will introduce an easy-to-use, yet comprehensive tool for document quality assessment. Alice Jane will demonstrate how this tool provides granular feedback so that you can improve your documentation, and provide empirical data so that you can track your or your team&#8217;s progress towards better quality documentation, improve your documentation department&#8217;s quality of output, and create useful documentation metrics.</p><h3>Our Presenter, Alice Jane Emanuel</h3><p>Alice Jane Emanuel is a quality-assessment expert with more than 15 years of experience in large-scale regional and international peer review activities. She developed this tool out of a process of research and development that included years of working on peer review assessment tools, working with other peer review professionals, and marketing the business benefits of quality to corporate management in a fast-paced business world.</p><h3>Registration</h3><p>Sign up today at <a
href="http://stcwebinardocquality.eventbrite.com/" rel="external">http://stcwebinardocquality.eventbrite.com/</a>. All the details about the registration process are there, along with the time of the webinar in your time zone. (If in doubt about the time for you, use <a
href="http://timeanddate.com/worldclock/converter.html" rel="external">the Time and Date converter tool</a>.)</p><h3>Pricing</h3><ul><li>Free: Members of STC&#8217;s Europe SIG and France Chapter</li><li>15 Euros: Members of STC, CRT, ISTC, and other Intecom societies</li><li>30 Euros: Non-STC members (consider <a
href="http://stc.org/membership/join-or-renew-now" rel="external">joining STC</a> and the chapter or SIG today to get the reduced rate!)</li></ul> ]]></content:encoded> <wfw:commentRss>http://www.stc-europe.org/2011/03/13/webinar-measure-the-quality-of-your-documentation-22-march/feed/</wfw:commentRss> <slash:comments>0</slash:comments> </item> </channel> </rss>
