<?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; General</title>
	<atom:link href="http://www.onemanwrites.co.uk/category/general/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>Ho ho &#8230; ho?</title>
		<link>http://www.onemanwrites.co.uk/2011/12/12/ho-ho-ho-2/</link>
		<comments>http://www.onemanwrites.co.uk/2011/12/12/ho-ho-ho-2/#comments</comments>
		<pubDate>Mon, 12 Dec 2011 09:18:33 +0000</pubDate>
		<dc:creator>Gordon McLean</dc:creator>
				<category><![CDATA[General]]></category>
		<category><![CDATA[ISTC]]></category>

		<guid isPermaLink="false">http://www.onemanwrites.co.uk/?p=846</guid>
		<description><![CDATA[It&#8217;s true. I&#8217;ve checked the calendar. Twice. It is definitely almost Christmas. Which means it&#8217;s almost the end of the year. How did that happen? I&#8217;m a bit disappointed that I&#8217;ve not yet managed to get the new ISTC website up and running. It&#8217;s close, so close, and after a few frustrating weeks of backtracking [...]]]></description>
			<content:encoded><![CDATA[<p>It&#8217;s true.</p>
<p>I&#8217;ve checked the calendar.</p>
<p>Twice.</p>
<p>It is definitely almost Christmas.</p>
<p>Which means it&#8217;s almost the end of the year.</p>
<p>How did that happen?</p>
<p>I&#8217;m a bit disappointed that I&#8217;ve not yet managed to get the new ISTC website up and running. It&#8217;s close, so close, and after a few frustrating weeks of backtracking and replanning part of the implementation (the member database part, quite important that bit!) I now have a clear path forward and will be looking to get it tested (I have volunteers already, more welcomed!) in the next few weeks.</p>
<p>Mind you, the past six months have been hectic but well worth it. We&#8217;ve grown our team and have a strong plan of action for the coming year, the challenge will be getting it all done.</p>
<p>So, next year is looking like it will be a good one.</p>
<p>Mind you, still need to get past the next couple of weeks.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.onemanwrites.co.uk/2011/12/12/ho-ho-ho-2/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>ISTC West of Scotland meeting</title>
		<link>http://www.onemanwrites.co.uk/2011/02/14/istc-west-of-scotland-meeting/</link>
		<comments>http://www.onemanwrites.co.uk/2011/02/14/istc-west-of-scotland-meeting/#comments</comments>
		<pubDate>Mon, 14 Feb 2011 13:29:17 +0000</pubDate>
		<dc:creator>Gordon McLean</dc:creator>
				<category><![CDATA[General]]></category>

		<guid isPermaLink="false">http://www.onemanwrites.co.uk/2011/02/14/istc-west-of-scotland-meeting/</guid>
		<description><![CDATA[The next ISTC technical communicators&#8217; meeting in Glasgow will take place on Monday 21st February 2011, from 7.30 pm onwards. Come along to talk about latest news and trends in communication, or just to meet other communication professionals. The event is free and open to anyone interested in technical communication, such as technical authors, information [...]]]></description>
			<content:encoded><![CDATA[<p>The next ISTC technical communicators&#8217; meeting in Glasgow will take place on Monday 21st February 2011, from 7.30 pm onwards. Come along to talk about latest news and trends in communication, or just to meet other communication professionals.</p>
<p>The event is free and open to anyone interested in technical communication, such as technical authors, information architects, internal communication professionals, report writers, marketing writers, web content writers and graphic designers.</p>
<p>Venue: Waxy O&#8217;Connors pub, 44 West George Street, Glasgow, G2 1DH. Please make your way to McTurk&#8217;s Room on the middle level.</p>
<p>Please forward this message on to your colleagues or anyone else who may be interested. For more information, contact westscotland_areagroup@istc.org.uk or visit http://istcwestofscotland.eventbrite.com/</p>
]]></content:encoded>
			<wfw:commentRss>http://www.onemanwrites.co.uk/2011/02/14/istc-west-of-scotland-meeting/feed/</wfw:commentRss>
		<slash:comments>1</slash:comments>
		</item>
		<item>
		<title>Looking forward</title>
		<link>http://www.onemanwrites.co.uk/2010/12/08/looking-forward/</link>
		<comments>http://www.onemanwrites.co.uk/2010/12/08/looking-forward/#comments</comments>
		<pubDate>Wed, 08 Dec 2010 09:51:18 +0000</pubDate>
		<dc:creator>Gordon McLean</dc:creator>
				<category><![CDATA[General]]></category>
		<category><![CDATA[Introspection]]></category>
		<category><![CDATA[ISTC]]></category>

		<guid isPermaLink="false">http://www.onemanwrites.co.uk/?p=754</guid>
		<description><![CDATA[2011 looms larger and larger in my view and as we start to plan out our goals and aims for the coming year, so I find myself increasingly struggle to make time to write some blog posts, add to that a couple of weeks of food poisoning, and I&#8217;m a little behind with things. That [...]]]></description>
			<content:encoded><![CDATA[<p>2011 looms larger and larger in my view and as we start to plan out our goals and aims for the coming year, so I find myself increasingly struggle to make time to write some blog posts, add to that a couple of weeks of food poisoning, and I&#8217;m a little behind with things.</p>
<p>That said, it is looking like we are well placed to enter the new year with all the foundations in place to make measureable improvements to the information we offer. We have routes into customer projects via support call outcome codes (if it was an information related issue, I&#8217;m contacting the project to see how it arose and what we can do to fix it), stats on what areas of our knowledge centre are being accessed down to the topic level, via our recent upgrade of Author-it, which will allow us to target the areas of the documentation that are being most heavily used, and we will soon be launching a Q&#038;A style forum within our developer community website, allowing a level of user-generated content to be available to all of our customers.</p>
<p>Personally I&#8217;ve started to get to grips with the ISTC website and hope to use some of the time available over the holidays to crack on with moving it to a CMS. There is some restructuring required as well and I&#8217;m hoping to start adding some new sections in the early part of the year, more on that nearer the time!</p>
<p>To everyone who has visited this blog, I wish you all the very best for the coming festive period, and in to the coming year!</p>
]]></content:encoded>
			<wfw:commentRss>http://www.onemanwrites.co.uk/2010/12/08/looking-forward/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>Do you do PR?</title>
		<link>http://www.onemanwrites.co.uk/2010/11/09/do-you-do-pr/</link>
		<comments>http://www.onemanwrites.co.uk/2010/11/09/do-you-do-pr/#comments</comments>
		<pubDate>Tue, 09 Nov 2010 08:45:36 +0000</pubDate>
		<dc:creator>Gordon McLean</dc:creator>
				<category><![CDATA[General]]></category>
		<category><![CDATA[Profession]]></category>

		<guid isPermaLink="false">http://www.onemanwrites.co.uk/?p=742</guid>
		<description><![CDATA[I&#8217;m writing this whilst it is still fairly fresh (and only addled by a couple, ok ok, three pints of Guinness)&#8230; At the ISTC West of Scotland Area Group meeting last night talk turned to the fairly common topic of &#8220;no-one knows what we do&#8221;. There was some chat about the value we can bring [...]]]></description>
			<content:encoded><![CDATA[<p><img src="http://retailrehab.co.uk/blog/wp-content/uploads/2009/03/chat-teeth-pr2.jpg" alt="Chattering teeth" width="510" /><br clear="all"></p>
<p>I&#8217;m writing this whilst it is still fairly fresh (and only addled by a couple, ok ok, three pints of Guinness)&#8230;</p>
<p>At the ISTC West of Scotland Area Group meeting last night talk turned to the fairly common topic of &#8220;no-one knows what we do&#8221;. There was some chat about the value we can bring but, frequently, documentation is still seen as a &#8220;tick in the box&#8221;, a necessary evil or, even worse, an apathetic acceptance even though no-one else in the company quite knows why we exist other than the fact that we do.</p>
<p>I had made a point earlier about selling ourselves, marketing our services and capabilities and once again it seems obvious that, and I acknowledge that I&#8217;m no better than anyone else in this respect, we must do a better job of raising our profiles as professionals within our organisation, and of the profession itself.</p>
<p>Talk of past redundancies confirms this, documentation can easily be seen as an expensive cost, something which, surely, could be cheaper to create or be created by cheaper individuals or perhaps be done away with altogether? After all, no-one reads the documentation and everyone can write, how hard could it be?</p>
<p>But how?</p>
<p>Alas we didn&#8217;t get to that during our discussions, but I have a few ideas. For starters, we need to:</p>
<ul>
<li>Identify champions, people within our organisation who understand the value we add to the product, and ask them for help.</li>
<li>Confirm our main customers are getting what they need from us (what they really need, not just the tick-the-box documents they&#8217;ve always received).</li>
<li>Communicate with our areas of the company more regularly so they know what we do</li>
</ul>
<p>Nothing startlingly original there but one thing we all agreed on last night was that it was very easy to get into &#8216;head down&#8217; mode, when you come into the office and work hard at to produce documentation, help systems, training guides, whitepapers, instructional videos, and more.</p>
<p>We need to, as a profession and as individuals, try to break out of those habits.</p>
<p>Yes, it&#8217;s hard, very hard in some situations, but most companies should be receptive to ideas which help make things better. It may be that your first port of call is to your boss to discuss why it would be a good idea to spend more time talking to the customers of your documentation, or it may be that another department is struggling and would welcome some helpful tips and a bit of direction.</p>
<p>We are professionals, and have much more to offer an organisation than information products alone. It&#8217;s just that sometimes we need to remind people of that, including ourselves.</p>
<p>Have you successfully conquered this? Do you indulge in PR and Marketing of your services, or the services of the team you are in? What has worked for you? I&#8217;d love to hear your thoughts and comments on this one.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.onemanwrites.co.uk/2010/11/09/do-you-do-pr/feed/</wfw:commentRss>
		<slash:comments>4</slash:comments>
		</item>
		<item>
		<title>Where are we going?</title>
		<link>http://www.onemanwrites.co.uk/2010/10/08/where-are-we-going/</link>
		<comments>http://www.onemanwrites.co.uk/2010/10/08/where-are-we-going/#comments</comments>
		<pubDate>Fri, 08 Oct 2010 12:40:35 +0000</pubDate>
		<dc:creator>Gordon McLean</dc:creator>
				<category><![CDATA[General]]></category>
		<category><![CDATA[Theory]]></category>

		<guid isPermaLink="false">http://www.onemanwrites.co.uk/?p=734</guid>
		<description><![CDATA[As the end of the year starts to draw close, inevitably thoughts turn to 2011 and the challenges that may lie ahead. From a product point of view we are starting to get a feel of how the year will shape up, and so we can start to look at how our team negotiates the [...]]]></description>
			<content:encoded><![CDATA[<p>As the end of the year starts to draw close, inevitably thoughts turn to 2011 and the challenges that may lie ahead. From a product point of view we are starting to get a feel of how the year will shape up, and so we can start to look at how our team negotiates the (still forming) landscape.</p>
<p>It already looks likely that our aim (alongside keeping pace with product development) will be to get to a point where we can correctly focus our efforts around structure, and ad-hoc document requessts. Given that we have access to outcome codes from the Support team, several of which are specifically around product documentation being either wrong, missing, or not read at all, and we will soon have a full set of analytics from our online product documentation, which should put us in a much better position to correctly prioritise those additional work streams rather than fall into the &#8220;whoever shouts loudest&#8221; model we are currently prey to.</p>
<p>The analytics are powered by Google Analytics and track visits to each topic of the documentation set. The numbers should help point is to areas of the documentation that, for one reason or another, need some attention. This works both ways of course, a high number of views indicates a lot of people using the information, but where are they going afterwards? If they head to the Support area of the website then can we presume the information isn&#8217;t correct? And those topics with little to no views, are they not used because they can&#8217;t be found?</p>
<p>I&#8217;m a little wary of spending too much time analysing the statistics and initially they will be used purely to direct us to the outliers, those topics that for one reason or another are causing anomalies in the reported numbers. Once we smooth those out then it will require a lot more deep-dive style root cause analysis which, as with everything else, will bring a fresh set of challenges and hopefully some new routes of communication with our customers.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.onemanwrites.co.uk/2010/10/08/where-are-we-going/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
	</channel>
</rss>

