<?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; Technology</title>
	<atom:link href="http://www.onemanwrites.co.uk/category/technology/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.onemanwrites.co.uk</link>
	<description>musings on technical communications</description>
	<lastBuildDate>Thu, 29 Jul 2010 21:12:38 +0000</lastBuildDate>
	<generator>http://wordpress.org/?v=2.9.1</generator>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
			<item>
		<title>Further Webhelp hacking</title>
		<link>http://www.onemanwrites.co.uk/2010/03/12/further-webhelp-hacking/</link>
		<comments>http://www.onemanwrites.co.uk/2010/03/12/further-webhelp-hacking/#comments</comments>
		<pubDate>Fri, 12 Mar 2010 08:14:03 +0000</pubDate>
		<dc:creator>Gordon McLean</dc:creator>
				<category><![CDATA[Author-it]]></category>
		<category><![CDATA[Technology]]></category>

		<guid isPermaLink="false">http://www.onemanwrites.co.uk/?p=599</guid>
		<description><![CDATA[I mentioned in my previous post that we run a webhelp build of our content (a.k.a. our Knowledge Centre) on our developer community website, and that it was hosted in an iframe. I thought it worthwhile fleshing out the detail of that as it includes a bit of custom code some others might find useful.
As [...]]]></description>
			<content:encoded><![CDATA[<p>I mentioned in my previous post that we run a webhelp build of our content (a.k.a. our Knowledge Centre) on our developer community website, and that it was hosted in an iframe. I thought it worthwhile fleshing out the detail of that as it includes a bit of custom code some others might find useful.</p>
<p>As our content is locked behind a login, we need to be sure that only people who are logged in can access it. This is achieved by a couple of simple checks.</p>
<p>1. When the Knowledge Centre is loaded, a script runs that checks it has been loaded within the correct iFrame within our website. If it&#8217;s not, the user is redirected to the login page. </p>
<p>The javascript for this is added to the webhelp.js file (around line 106):</p>
<blockquote><p>//&#8212;&#8212;&#8212;&#8211; init function &#8212;&#8212;&#8212;&#8212;<br />
Kbase.init = function() {</p>
<p>	//OUR redirect<br />
	if(window.top.location==window.location) {<br />
		window.top.location = &#8216;URLTOYOURIFRAME&#8217;;<br />
		}</p></blockquote>
<p>2. If the Knowledge Centre has been loaded in the correct iFrame (in other words the above javascript is happy), the website checks for a cookie (checking for login) and then either loads the Knowledge Centre, or, again, redirects the user to the login page. The javascript for this is standard cookie checking stuff (google will find you a zillion solutions).</p>
<p>And that&#8217;s it. Nothing particularly clever, but a useful way to (lightly) protect the content of our Knowledge Centre.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.onemanwrites.co.uk/2010/03/12/further-webhelp-hacking/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>On Google Wave</title>
		<link>http://www.onemanwrites.co.uk/2010/02/09/on-google-wave/</link>
		<comments>http://www.onemanwrites.co.uk/2010/02/09/on-google-wave/#comments</comments>
		<pubDate>Tue, 09 Feb 2010 19:12:45 +0000</pubDate>
		<dc:creator>Gordon McLean</dc:creator>
				<category><![CDATA[Technology]]></category>
		<category><![CDATA[Web]]></category>

		<guid isPermaLink="false">http://www.onemanwrites.co.uk/?p=580</guid>
		<description><![CDATA[I think I&#8217;m starting to get it. I&#8217;ve used it a couple of times but not for any other reason than to play with it, but now I have an actual need for a place to collaborate with a group of geographically displaced people, the ISTC Community website, it&#8217;s starting to make sense.
And I&#8217;m not [...]]]></description>
			<content:encoded><![CDATA[<p>I think I&#8217;m starting to get it. I&#8217;ve used it a couple of times but not for any other reason than to play with it, but now I have an actual need for a place to collaborate with a group of geographically displaced people, the ISTC Community website, it&#8217;s starting to make sense.</p>
<p>And I&#8217;m not the only person that thinks <a href="http://blog.cubeofm.com/on-how-google-wave-surprisingly-changed-my-li">Google Wave is best suited to this kind of collaboration</a>.</p>
<p>I&#8217;ve realised that what Google have done is take the best bits from a couple of different communication channels, combine them and add a couple of improvements.</p>
<p>Those channels are email and Wiki, with a hint of instant messaging thrown in for good measure.</p>
<p>The easiest comparison is to email, with threaded conversations the main thrust of a Wave, but as you can edit and &#8216;interrupt&#8217; any part of an existing message, with that edit viewable to everyone else on the wave, soon you begin to realise that it&#8217;s more like a message based Wiki.</p>
<p>The ability to see new messages in real-time adds in a type of instant messaging but I think the value stands in the staggered, traceable, timelined edits of messages. For <a href="http://lifehacker.com/5407183/how-to-manage-a-group-project-in-google-wave">a collaborative, group project workspace</a> this is wonderful.</p>
<p>I&#8217;m still learning Google Wave and as it&#8217;s still being developed there are a few quirks and annoyances to be overcome but despite those, so far, they are far outweighed by the benefits.</p>
<p>There are other <a href="http://lifehacker.com/5466862/google-wave-in-action-real+world-use-case-studies">use cases of Google Wave in action</a>, and if you are interested, I do have a small number of invites left.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.onemanwrites.co.uk/2010/02/09/on-google-wave/feed/</wfw:commentRss>
		<slash:comments>4</slash:comments>
		</item>
		<item>
		<title>Analyse this</title>
		<link>http://www.onemanwrites.co.uk/2010/01/08/analyse-this/</link>
		<comments>http://www.onemanwrites.co.uk/2010/01/08/analyse-this/#comments</comments>
		<pubDate>Fri, 08 Jan 2010 10:56:03 +0000</pubDate>
		<dc:creator>Gordon McLean</dc:creator>
				<category><![CDATA[Author-it]]></category>
		<category><![CDATA[Technology]]></category>

		<guid isPermaLink="false">http://www.onemanwrites.co.uk/?p=554</guid>
		<description><![CDATA[Let me tell you a story. In it our hero (me) fights valiantly against two Javascript dragons called Webhelp and Google Analytics. It&#8217;s a bloody battle and at the end, when all the fighting is done, well &#8230; you&#8217;ll have to read on and find out.
Some background first. 
We have a developer community website which [...]]]></description>
			<content:encoded><![CDATA[<p>Let me tell you a story. In it our hero (me) fights valiantly against two Javascript dragons called Webhelp and Google Analytics. It&#8217;s a bloody battle and at the end, when all the fighting is done, well &#8230; you&#8217;ll have to read on and find out.</p>
<p>Some background first. </p>
<p>We have a developer community website which hosts downloads of our software and all the documentation in PDF format. To make it easier for people to find information in the product documentation, we also host a Webhelp version of each and every document in one master Webhelp system so you can search across the entire thing. It works really well.</p>
<p>To track how the other areas of the website are used, we have a Google Analytics account and the necessary code has been added. For the Webhelp, the code is in both the index.htm and topic.htm files. </p>
<p>But, and this is where the story begins, it doesn&#8217;t work properly.</p>
<p>Google Analytics will happily track every visit to the WebHelp system, but it stops there. Any click made within the system is recorded as a click but there is no detail on WHAT topic was viewed. We had hoped to get stats on this to allow us to better focus on the areas of the product people were enquiring about but we are, essentially, blind.</p>
<p>It&#8217;s very annoying.</p>
<p>Why is this so? Well I think it&#8217;s to do with the way WebHelp is created. It uses a Javascript library called <a href="http://www.extjs.com/">Ext JS</a> which, amongst other things, means that every time you open a topic in the Webhelp, it&#8217;s loaded through a Javascript call so Google Analytics never &#8217;sees&#8217; a new HTML page (a new topic) being loaded so doesn&#8217;t know what you are viewing.</p>
<p>I think. I&#8217;m not 100% sure to be honest.</p>
<p>I&#8217;ve logged a somewhat vague Support call with Author-it, and have enlisted the help of our own webmaster. Next step will be to beg and plead with some of the developers for some of their brain power (most of them have a fair bit to spare).</p>
<p>It&#8217;s hugely annoying, being so close to what we want but not able to fix it myself, but sometimes you just have to admit defeat.</p>
<p>Of the battle, that is. I WILL win the war!</p>
]]></content:encoded>
			<wfw:commentRss>http://www.onemanwrites.co.uk/2010/01/08/analyse-this/feed/</wfw:commentRss>
		<slash:comments>1</slash:comments>
		</item>
		<item>
		<title>Paper based</title>
		<link>http://www.onemanwrites.co.uk/2009/08/11/paper-based/</link>
		<comments>http://www.onemanwrites.co.uk/2009/08/11/paper-based/#comments</comments>
		<pubDate>Tue, 11 Aug 2009 12:53:19 +0000</pubDate>
		<dc:creator>Gordon McLean</dc:creator>
				<category><![CDATA[Profession]]></category>
		<category><![CDATA[Technology]]></category>

		<guid isPermaLink="false">http://www.onemanwrites.co.uk/?p=405</guid>
		<description><![CDATA[I am a paper junkie. I&#8217;m a whore for a nice caliper of paper, not too thick as to be card, not too thin as to be unsubstantial. I love the feel of paper, the rustle and rigidity that give way with a subtle movement. I love the sound of ink being laid down, the [...]]]></description>
			<content:encoded><![CDATA[<p>I am a paper junkie. I&#8217;m a whore for a nice caliper of paper, not too thick as to be card, not too thin as to be unsubstantial. I love the feel of paper, the rustle and rigidity that give way with a subtle movement. I love the sound of ink being laid down, the gentle drag as my hand loops and dots across the page.</p>
<p>Despite all the advances of modern technology, I don&#8217;t see this changing. In fact I&#8217;m such a slave to this way of thinking that I&#8217;ll often print off an email if it contains important information that I&#8217;ll need at some point in the next day or so. </p>
<p>As such I walk around with a notebook (A4 size, hard bound, company branded) stuffed with &#8216;important&#8217; sheets of information, with said sheets usually adorn with numerous, equally important, scribbles and notes. </p>
<p>And of course there in lies the problem. As of yet computers cannot match the speed nor convenience of pen/pencil and paper. </p>
<p>It is then a short leap and a step to full on stationery porn. Lusting over Moleskin notepads, gushing over the smooth flow of ink from a Mont Blanc. I&#8217;m not quite there yet. Yet.</p>
<p>But what of paper in our profession? The last time I was involved with a print house was over 10 years ago (blimey), and these days whilst we still produce user manuals, they are in the now ubiquitous PDF format. Information these days is largely thought of in electronic terms, yet everyone I know prefers reading novels in &#8216;old fashioned&#8217; print format.</p>
<p>And I guess that is the problem, whilst the main thing we consume and produce is electronically focussed, many of us are still looking to paper as the medium. Which, if you are a paper junkie like me, is a good and a bad thing.</p>
<p>But mostly bad.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.onemanwrites.co.uk/2009/08/11/paper-based/feed/</wfw:commentRss>
		<slash:comments>2</slash:comments>
		</item>
		<item>
		<title>No Kahuna</title>
		<link>http://www.onemanwrites.co.uk/2009/08/03/no-kahuna/</link>
		<comments>http://www.onemanwrites.co.uk/2009/08/03/no-kahuna/#comments</comments>
		<pubDate>Mon, 03 Aug 2009 13:18:42 +0000</pubDate>
		<dc:creator>Gordon McLean</dc:creator>
				<category><![CDATA[Software]]></category>
		<category><![CDATA[Technology]]></category>

		<guid isPermaLink="false">http://www.onemanwrites.co.uk/?p=394</guid>
		<description><![CDATA[A few weeks ago I mentioned that we were looking for a new way track our tasks. After checking out a few different applications and web applications, I think we have a solution.
The problem we have is that, whilst the bulk of the work is scheduled against a project plan, there are a myriad of [...]]]></description>
			<content:encoded><![CDATA[<p>A few weeks ago <a href="http://www.onemanwrites.co.uk/2009/07/17/tracking-progress/">I mentioned that we were looking for a new way track our tasks</a>. After checking out a few different applications and web applications, I think we have a solution.</p>
<p>The problem we have is that, whilst the bulk of the work is scheduled against a project plan, there are a myriad of smaller tasks and documentation changes that we need to track. These come in through various channels, our Support team, our &#8216;Core&#8217; team (who maintain the latest stream of the product), and through our team inbox.</p>
<p>Previously we mirrored the development teams approach and used index cards and a BIG whiteboard but it wasn&#8217;t really working for us for a variety of reasons. So I spent a couple of days downloading task tracking applications, and hunting for a web-based application that might meet our needs.</p>
<p>There are many out there and the first thing I realised is that most of the are aimed at the project management set and are very date driven. Most of the tasks we wanted to track aren&#8217;t heavily date driven, and so are picked up as and when the team has a some spare time in the project plan.</p>
<p>One of the first applications I found was <a href="http://www.teamworkpm.net/">TeamWorkPM</a> which seemed to fit our needs and then some. However it was still quite over-spec&#8217;d for what we had in mind so when I stumbled over <a href="http://nokahuna.com/">No Kahuna</a> it was soon apparent that I&#8217;d found a good match.</p>
<p>Importantly, No Kahuna is a task tracking application. Dates do not feature. You simply create a project, add project members, then start creating tasks. You can assign a task to a specific project member (or take it for yourself) and when it&#8217;s done, it&#8217;s marked as completed.</p>
<p>You can add comments to tasks, which is useful when some tasks may sit in the list for a while so you can build out a level of information for when they are finally actioned. </p>
<p>All very simple, it worked well enough in our short trial that I&#8217;m happy to shell out $7 a month to get a private project (not visible to the public). If you are looking for an online, lightweight task tracker, <a href="http://nokahuna.com/">check out No Kahuna</a>.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.onemanwrites.co.uk/2009/08/03/no-kahuna/feed/</wfw:commentRss>
		<slash:comments>4</slash:comments>
		</item>
	</channel>
</rss>
