<?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>one man writes &#187; Profession</title>
	<atom:link href="http://www.onemanwrites.co.uk/category/profession/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.onemanwrites.co.uk</link>
	<description>musings on technical communications</description>
	<lastBuildDate>Wed, 18 Jan 2012 20:01:49 +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>Always learning</title>
		<link>http://www.onemanwrites.co.uk/2011/07/26/always-learning/</link>
		<comments>http://www.onemanwrites.co.uk/2011/07/26/always-learning/#comments</comments>
		<pubDate>Tue, 26 Jul 2011 14:54:25 +0000</pubDate>
		<dc:creator>Gordon McLean</dc:creator>
				<category><![CDATA[Management]]></category>
		<category><![CDATA[Profession]]></category>

		<guid isPermaLink="false">http://www.onemanwrites.co.uk/?p=811</guid>
		<description><![CDATA[Next week the first of two new recruits joins our team. Both are graduates and whilst neither graduated from a Technical Writing based course they both have a good mix of skills, coming to the position through different routes. It&#8217;ll be a challenge for them, and a challenge for us, to integrate them to the [...]]]></description>
			<content:encoded><![CDATA[<p>Next week the first of two new recruits joins our team. Both are graduates and whilst neither graduated from a Technical Writing based course they both have a good mix of skills, coming to the position through different routes. It&#8217;ll be a challenge for them, and a challenge for us, to integrate them to the team smoothly and successfully. I&#8217;m sure they will both do well, but to give them the best chance I&#8217;m preparing a few weeks of training for them, in various aspects of the job.</p>
<p>I&#8217;m trying to anticipate what they need to know, and when they need to know it, and whilst I&#8217;m very wary of letting my own experience get in the way it does mirror what they will be going through as my route into this profession was via an Electronic Engineering course, and I too had no experience in Technical Writing. </p>
<p>Training on our authoring tool (<a href="http://www.author-it.com">Author-it</a>) is straightforward enough, and we will be mentoring each of the recruits as well so day to day questions we can handle. </p>
<p>We will likely use the IBM book &#8220;<a href="http://www.amazon.co.uk/Developing-Quality-Technical-Information-Information/dp/0131477498">Developing Quality Technical Information</a>&#8221; to provide a grounding in the basics of Technical Writing, along with an eLearning book titled <a href="http://www.cherryleaf.com/">Basics of Technical Writing</a> that we purchased from CherryLeaf a few years ago. </p>
<p>They will have to learn how we do things, our specific processes, and learn how the overall Development team works so they understand where they fit, and they will receive a series of training exercises to complete before they take our product training course. On top of all that they will have a week long company Induction.</p>
<p>I&#8217;m a great believer in people learning by doing, so I&#8217;m planning a set of small tasks which will be checked and reviewed, and which will ultimately find their way into our documentation set.</p>
<p>Beyond that, I&#8217;ll be looking for them to ask questions, try things, make mistakes and learn from them, and then ask more questions. This industry is too varied to try and learn everything at once, and ultimately it&#8217;s down to them to decide what areas they want to push into&#8230; user experience? content design? API information? Who knows.</p>
<p>I do know it&#8217;s a challenge, for everyone involved, and that&#8217;s one of the things we, as a company, do best. There is a saying we have about being two feet outside your comfort zone, that&#8217;s where you learn best, that&#8217;s where you grow and start to understand your capabilities, so we will see how our recruits get on!</p>
<p>For me it&#8217;s doubly exciting as this is only the second time I&#8217;ve taken on graduates. I learned a lot the last time, both about how to train them and about my own foibles and attitudes to my profession so I&#8217;m brushing up my own knowledge to make sure I, and the rest of the team, give them the best change they have. In saying that, the first time I did this I was in my first &#8216;senior&#8217; position, that was 10 years ago so hopefully by now I&#8217;ve gained a little bit more experience!</p>
<p>After all, you learn something new every day.</p>
<p>Have you brought a graduate into your team? Or are you involved in training or mentoring new recruits? If you have any suggestions I&#8217;d love to hear them.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.onemanwrites.co.uk/2011/07/26/always-learning/feed/</wfw:commentRss>
		<slash:comments>6</slash:comments>
		</item>
		<item>
		<title>Conference chatter</title>
		<link>http://www.onemanwrites.co.uk/2011/06/16/conference-chatter/</link>
		<comments>http://www.onemanwrites.co.uk/2011/06/16/conference-chatter/#comments</comments>
		<pubDate>Thu, 16 Jun 2011 13:24:12 +0000</pubDate>
		<dc:creator>Gordon McLean</dc:creator>
				<category><![CDATA[Conference]]></category>
		<category><![CDATA[ISTC]]></category>
		<category><![CDATA[Profession]]></category>

		<guid isPermaLink="false">http://www.onemanwrites.co.uk/?p=788</guid>
		<description><![CDATA[&#8220;The time has come,&#8221; the Walrus said, &#8220;To talk of many things&#8230;&#8221; It&#8217;s that time of year again, with the UA Conference currently underway (see what people are saying about it on Twitter) and the Technical Communication UK conference just around the corner. We are lucky enough to be able to get to such events, [...]]]></description>
			<content:encoded><![CDATA[<p><em>&#8220;The time has come,&#8221; the Walrus said, &#8220;To talk of many things&#8230;&#8221;</em></p>
<p>It&#8217;s that time of year again, with the UA Conference currently underway (<a href="https://twitter.com/#!/search?q=#uaeurope2011">see what people are saying about it on Twitter</a>) and the <a href="http://www.technicalcommunicationuk.com/">Technical Communication UK conference</a> just around the corner.</p>
<p>We are lucky enough to be able to get to such events, even though we still need to pick and choose due to budget constraints and, once again, the multi-stream approach of TCUK makes it easier to justify. Looking at the programme for this year, there are always two sessions of interest, sometimes three.</p>
<p>As ever, and this is something I&#8217;ve commented on before, the benefits of attending conferences go above and beyond attendance at the sessions. The conversations over lunch, or dinner, or over a quick coffee between sessions make all the difference. Being able to bounce ideas off fellow professionals from different companies (working in different industries) gives you some unique views and solutions which you would struggle to get otherwise.</p>
<p>Add in the additional interaction via Twitter and conferences can become a mind-bogglingly fast-paced solution centre!</p>
<p>Of course implementing those solutions is a different challenge but I&#8217;ve yet to come away from a conference NOT feeling energised and ready to tackle things and, again, social media then helps extend those conversations.</p>
<p>Creating the business case for attending a conference is usually centred around the sessions, and what the value and benefits of attending will be to the company, but I think it&#8217;s also worth factoring in the availability of your peers as part of that discussion.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.onemanwrites.co.uk/2011/06/16/conference-chatter/feed/</wfw:commentRss>
		<slash:comments>5</slash:comments>
		</item>
		<item>
		<title>Learning from others</title>
		<link>http://www.onemanwrites.co.uk/2011/02/23/learning-from-others-2/</link>
		<comments>http://www.onemanwrites.co.uk/2011/02/23/learning-from-others-2/#comments</comments>
		<pubDate>Wed, 23 Feb 2011 13:59:26 +0000</pubDate>
		<dc:creator>Gordon McLean</dc:creator>
				<category><![CDATA[Profession]]></category>
		<category><![CDATA[Web]]></category>

		<guid isPermaLink="false">http://www.onemanwrites.co.uk/?p=762</guid>
		<description><![CDATA[Whilst compiling my column for the ISTC newsletter this month (I offer a round up of the &#8216;best&#8217; blog posts from the past month, hugely subjective I know) I was worried I&#8217;d skewed the resulting list of blog posts somewhat. You see the team I&#8217;m part of are about to embark on a couple of [...]]]></description>
			<content:encoded><![CDATA[<p>Whilst compiling my column for the ISTC newsletter this month (I offer a round up of the &#8216;best&#8217; blog posts from the past month, hugely subjective I know) I was worried I&#8217;d skewed the resulting list of blog posts somewhat.</p>
<p>You see the team I&#8217;m part of are about to embark on a couple of brainstorming workshops to try and better improve the quality of our work and, lo and behold, it seems that there have been a few blog posts last month that feature, or discuss, how to be better, how to improve quality.</p>
<p>I scanned back through my <a href="http://www.instapaper.com">Instapaper account</a> (an excellent bookmarking/article reading facility) but it was true, it seemed that other people were thinking similar things at a similar time.</p>
<p>Coincidence? Perhaps, but this kind of thing seems to happen too often to be just that. I wonder if there is some sort of cycle involved here, and that the people who share their ideas on blogs are falling into a similar pattern.</p>
<p>Or perhaps that pattern already existed but it&#8217;s only becoming evident now as more and more people discuss and share ideas online?</p>
<p>Regardless, that sharing of ideas is hugely beneficial and reminds me that I really should do more of that here. Whilst no two situations, companies, or teams are the same, there is always a common level of information and experience from which we can all learn.</p>
<p>Whether it&#8217;s back to basics reminders, or more in-depth analysis of a specific issue, being able to tap into the collective mind of so many talented, intelligent and helpful people is something that is worth remembering.</p>
<p>We are all awesome.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.onemanwrites.co.uk/2011/02/23/learning-from-others-2/feed/</wfw:commentRss>
		<slash:comments>3</slash:comments>
		</item>
		<item>
		<title>Technology vs Emotion</title>
		<link>http://www.onemanwrites.co.uk/2011/02/01/technology-vs-emotion/</link>
		<comments>http://www.onemanwrites.co.uk/2011/02/01/technology-vs-emotion/#comments</comments>
		<pubDate>Tue, 01 Feb 2011 21:42:43 +0000</pubDate>
		<dc:creator>Gordon McLean</dc:creator>
				<category><![CDATA[Profession]]></category>
		<category><![CDATA[Theory]]></category>

		<guid isPermaLink="false">http://www.onemanwrites.co.uk/?p=758</guid>
		<description><![CDATA[Random thought: Has the rise of (talk of) emotional content (affective assistance) been driven by the concentration, over the last few years, on technological solutions? Single sourcing, XML, DITA, DocBook, and all the rest have (rightly) taken our profession forward, so I guess it&#8217;s natural that the general trends, as well as refocussing on the [...]]]></description>
			<content:encoded><![CDATA[<p>Random thought: Has the rise of (talk of) emotional content (affective assistance) been driven by the concentration, over the last few years, on technological solutions?</p>
<p>Single sourcing, XML, DITA, DocBook, and all the rest have (rightly) taken our profession forward, so I guess it&#8217;s natural that the general trends, as well as refocussing on the content itself, are looking for how to better engage with a modern audience.</p>
<p>The evidence suggests that that modern audience is Facebooking, Twittering, and blogging, and wants content in easily digestable chunks.</p>
<p>That plays nicely into the hands of single sourcing (chunks) and the idea of emotional content through connecting to the user, using friendly language to make the content easily digestable.</p>
<p>So, if you&#8217;ve already got your technology sorted out, why aren&#8217;t you looking at how your content is presented?</p>
]]></content:encoded>
			<wfw:commentRss>http://www.onemanwrites.co.uk/2011/02/01/technology-vs-emotion/feed/</wfw:commentRss>
		<slash:comments>5</slash:comments>
		</item>
		<item>
		<title>Challenges</title>
		<link>http://www.onemanwrites.co.uk/2011/01/10/challenges/</link>
		<comments>http://www.onemanwrites.co.uk/2011/01/10/challenges/#comments</comments>
		<pubDate>Mon, 10 Jan 2011 17:09:54 +0000</pubDate>
		<dc:creator>Gordon McLean</dc:creator>
				<category><![CDATA[Profession]]></category>
		<category><![CDATA[Theory]]></category>

		<guid isPermaLink="false">http://www.onemanwrites.co.uk/?p=756</guid>
		<description><![CDATA[I&#8217;m currently in the midst of some thinking. I&#8217;m thinking about how we can improve what we do, how we measure those improvements and ultimately how we make a step change in the quality of our output. Oh no, I used that word, didn&#8217;t I. Quality. At this point I will veer away from that [...]]]></description>
			<content:encoded><![CDATA[<p>I&#8217;m currently in the midst of some thinking. I&#8217;m thinking about how we can improve what we do, how we measure those improvements and ultimately how we make a step change in the quality of our output.</p>
<p>Oh no, I used that word, didn&#8217;t I.</p>
<p>Quality.</p>
<p>At this point I will veer away from that word, for fear of plunging headlong into the land of metrics, and instead outline some of the things floating around in my head.</p>
<p>To improve the perceived quality of the information, there are some things we can do:</p>
<ul>
<li>Improve the navigation</li>
<li>Improve the findability of the information</li>
<li>Improve the technical accuracy of the information</li>
<li>Improve the completeness of the information</li>
</ul>
<p>Navigation and findability are linked and we have some ideas on how to tackle those through better indexing, better understanding of the structures, addition of signposts and all those good things.</p>
<p>Improving the completeness and technical accuracy can be a little trickier to nail down though. No product documentation is ever complete but by improving our approach to collating information and the questions we ask, we can take start to make improvements, those same questions should also help improve the technical accuracy, as will a beefed up review process.</p>
<p>With all of this in mind, we will be running some workshops early February to revisit the basics. We will cover off every aspect of how we work, and step through how we can improve the outputs of all our hard work (well, all the hard work the team do, I mostly try and keep out of the road thesedays, they seem to work better that way!).</p>
<p>I&#8217;ve been with my current company for four years and, for each of those years the team have managed to make significant improvements in a variety of areas. Year One, the first members were hired and we set about improving the quality of the content, Year Two we launched our developer website as a means to make it easier to access the content we were creating (that website is about to relaunch in it&#8217;s third iteration), Year Three we transitioned from FrameMaker to Author-it and publish our Knowledge Centre to the developer website, and this coming year&#8230; well, time will tell.</p>
<p>I&#8217;ve no idea what we will decide to do, what processes we will change or adopt, what new ideas and challenges we will set ourselves, but this part of the job is the one I enjoy the most. Everything is fresh, new and exciting.</p>
<p>Roll on 2011!</p>
]]></content:encoded>
			<wfw:commentRss>http://www.onemanwrites.co.uk/2011/01/10/challenges/feed/</wfw:commentRss>
		<slash:comments>2</slash:comments>
		</item>
	</channel>
</rss>

