<?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>HCoder.org &#187; rants</title>
	<atom:link href="http://hcoder.org/tag/rants/feed/" rel="self" type="application/rss+xml" />
	<link>http://hcoder.org</link>
	<description>Just another WordPress weblog</description>
	<lastBuildDate>Sat, 04 Feb 2012 11:06:44 +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>Book review: &#8220;97 Things Every Project Manager Should Know&#8221;</title>
		<link>http://hcoder.org/2010/06/27/book-review-97-things-every-project-manager-should-know/</link>
		<comments>http://hcoder.org/2010/06/27/book-review-97-things-every-project-manager-should-know/#comments</comments>
		<pubDate>Sun, 27 Jun 2010 16:26:06 +0000</pubDate>
		<dc:creator>emanchado</dc:creator>
				<category><![CDATA[Computers]]></category>
		<category><![CDATA[Reviews]]></category>
		<category><![CDATA[book]]></category>
		<category><![CDATA[book depository]]></category>
		<category><![CDATA[books]]></category>
		<category><![CDATA[management]]></category>
		<category><![CDATA[project]]></category>
		<category><![CDATA[rants]]></category>
		<category><![CDATA[review]]></category>

		<guid isPermaLink="false">http://hcoder.org/?p=382</guid>
		<description><![CDATA[In the last batch of books I ordered from The Book Depository I had &#8220;97 Things Every Project Manager Should Know&#8220;. It was a thin book and one of the first to arrive, so I figured it was a good one to start. The book is a collection of 2-page articles about project management. It [...]]]></description>
			<content:encoded><![CDATA[<p>In the last batch of books I ordered from <a href="http://www.bookdepository.co.uk/">The Book Depository</a> I had &#8220;<a href="http://oreilly.com/catalog/9780596804152">97 Things Every Project Manager Should Know</a>&#8220;. It was a thin book and one of the first to arrive, so I figured it was a good one to start. The book is a collection of 2-page articles about project management. It has 198 pages, but I just read until around page 70, then &#8220;speed-read&#8221; the rest because I was so disappointed that I just wanted to get it over with. This has been the most disappointing book I&#8217;ve read in many years, and I rarely stop reading books even if I don&#8217;t like them that much (especially if they are as short as this one).</p>
<p>But I hate not trying to be constructive, and just saying that it was disappointing for <em>me</em> won&#8217;t tell you much about the possibility of it being disappointing for <em>you</em>, so here we go:</p>
<ul>
<li>The choice of articles seemed &#8220;random&#8221;: clearly some of the authors had very good things to share, but many others didn&#8217;t sound that experienced or having so much interesting to say. I could imagine <em>myself</em> writing some of those articles.</li>
<li>Many articles read like they want to give &#8220;general&#8221; advice, but extrapolating from circumstances that I may never have (like making a rule out of a &#8220;this happened to me once&#8221; kind of experience).</li>
<li>I didn&#8217;t find it &#8220;inspiring&#8221; at all, if I wasn&#8217;t a project manager already I would <em>not want</em> to become one. The idea of working as a project manager felt dry, boring, and too focused on processes.</li>
<li>Many articles feel written for someone that doesn&#8217;t have any project management experience whatsoever. That&#8217;s cool, but it&#8217;s useless for me and should have been clearer in the book I think.</li>
<li>Many other articles seem written for project managers from other industries (or even simply &#8220;managers&#8221;) that are going to start managing a software project. That is not only <em>plain useless</em> to me, it also bores me to death. Seriously, WTF is with the definitions of super basic concepts? If you don&#8217;t know what an &#8220;iteration&#8221; or a &#8220;hack&#8221; is and you won&#8217;t check yourself out of curiosity <strong>you shouldn&#8217;t be allowed to manage a software project</strong><strong>. Period.</strong></li>
<li>Many articles felt too &#8220;corporate&#8221; to me, there was too much jargon and too many references to job titles, methodologies and contractors instead of really essential stuff based on experience.</li>
<li>Reading some of the more or less interesting stuff, I couldn&#8217;t help thinking that those things would be obvious for someone who has been working as a software developer for years and wants to become a project manager because she finds it interesting.</li>
<li>Other articles were interesting, but lacked depth to make them really useful.</li>
</ul>
<p>Don&#8217;t get me wrong, there <em>are</em> useful articles, but the book as a whole doesn&#8217;t feel that useful. Certainly not worth the time reading the whole thing.</p>
<p>And finally, something that kept popping in my head, even if the comparison is unfair (it&#8217;s a different kind of book), is that this book is in many respects the opposite of the things I loved about <a href="http://oreilly.com/catalog/9780596517717">Making Things Happen</a> (an <strong>excellent</strong> book that you should read if you have any interest in project management). Oh well.</p>
 <p><a href="http://hcoder.org/?flattrss_redirect&amp;id=382&amp;md5=ef1c8a98dda58adaa1bc3df9c8e4fb5a" title="Flattr" target="_blank"><img src="http://hcoder.org/wp-content/plugins/flattr/img/flattr-badge-large.png" alt="flattr this!"/></a></p>]]></content:encoded>
			<wfw:commentRss>http://hcoder.org/2010/06/27/book-review-97-things-every-project-manager-should-know/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		<atom:link rel="payment" href="http://hcoder.org/?flattrss_redirect&amp;id=382&amp;md5=ef1c8a98dda58adaa1bc3df9c8e4fb5a" type="text/html" />
	</item>
		<item>
		<title>Facebook and privacy</title>
		<link>http://hcoder.org/2010/05/10/facebook-and-privacy/</link>
		<comments>http://hcoder.org/2010/05/10/facebook-and-privacy/#comments</comments>
		<pubDate>Mon, 10 May 2010 18:37:18 +0000</pubDate>
		<dc:creator>emanchado</dc:creator>
				<category><![CDATA[Freedom]]></category>
		<category><![CDATA[eff]]></category>
		<category><![CDATA[facebook]]></category>
		<category><![CDATA[privacy]]></category>
		<category><![CDATA[rants]]></category>

		<guid isPermaLink="false">http://hcoder.org/?p=348</guid>
		<description><![CDATA[Over the past few weeks I&#8217;ve become increasingly concerned about Facebook. I even considered deleting my account (idea I haven&#8217;t really discarded), but the amount of people I&#8217;m going to lose contact with is making me hesitate. So, why the concern? I&#8217;m glad you asked. You can get a rough idea by reading these articles: [...]]]></description>
			<content:encoded><![CDATA[<p>Over the past few weeks I&#8217;ve become increasingly concerned about Facebook. I even considered deleting my account (idea I haven&#8217;t really discarded), but the amount of people I&#8217;m going to lose contact with is making me hesitate.</p>
<p>So, why the concern? I&#8217;m glad you asked. You can get a rough idea by reading these articles:</p>
<ul>
<li><a href="https://www.eff.org/deeplinks/2010/04/facebook-timeline">Facebook&#8217;s Eroding Privacy Policy: A Timeline</a></li>
<li><a href="http://www.eff.org/deeplinks/2010/04/facebook-further-reduces-control-over-personal-information">Facebook Further Reduces Your Control Over Personal Information</a></li>
<li><a href="http://www.eff.org/deeplinks/2010/05/things-you-need-know-about-facebook">Six Things You Need to Know About Facebook Connections</a></li>
<li><a href="https://www.eff.org/deeplinks/2009/12/who-knows-who-your-facebook-friends-are">Who Knows Who Your Facebook Friends Are?</a></li>
<li><a href="http://mattmckeon.com/facebook-privacy/">The Evolution of Privacy on Facebook</a> (infographic)</li>
</ul>
<p>After reading all that, for me it&#8217;s pretty clear that Facebook doesn&#8217;t give a flying fuck about your privacy. Actually, even <a href="http://www.wired.com/epicenter/2010/04/report-facebook-ceo-mark-zuckerberg-doesnt-believe-in-privacy/">Zuckerberg presumably said so</a>. <em>That</em> is for me the big issue: the exact problems we might have now, the current workarounds, the fact that you now have this or that option to counter some of the automatic changes by Facebook&#8230; is all irrelevant. To elaborate a bit:</p>
<ol>
<li>Facebook started as a much more &#8220;private&#8221; space in which you only shared information with your friends. This has radically changed, and I somehow find it disrespectful toward their users. We&#8217;re not talking about evolution here, but of pretty big &#8220;philosophical&#8221; changes. <em>This is not what I signed up for</em>.</li>
<li>It has happened <em>several times</em> that Facebook has changed your privacy settings on updates. Some of those changes can&#8217;t even be countered, or it&#8217;s fairly hard to do so. That pisses me off.</li>
<li>The &#8220;Facebook messing with your privacy settings&#8221; will no doubt <em>happen again</em>. So now, instead of using/enjoying the service, I have to <em>fight</em> against it.</li>
</ol>
<p>So the current situation is that I know that Facebook can, at any moment, change something I don&#8217;t want it to, and I&#8217;ll have to read a bunch of articles to understand the threat and counter it. I don&#8217;t want to review my privacy settings from time to time &#8220;just in case&#8221;. I don&#8217;t want to wonder if my data is available to more people I&#8217;d like it to. I don&#8217;t see the point in using a service that is designed to do the <em>opposite</em> of what I want. And that makes me wonder why do I bother at all. Or if I want to support a company or service that behaves like that.</p>
 <p><a href="http://hcoder.org/?flattrss_redirect&amp;id=348&amp;md5=466b5a3fcff884a135079ad5f01d2764" title="Flattr" target="_blank"><img src="http://hcoder.org/wp-content/plugins/flattr/img/flattr-badge-large.png" alt="flattr this!"/></a></p>]]></content:encoded>
			<wfw:commentRss>http://hcoder.org/2010/05/10/facebook-and-privacy/feed/</wfw:commentRss>
		<slash:comments>3</slash:comments>
		<atom:link rel="payment" href="http://hcoder.org/?flattrss_redirect&amp;id=348&amp;md5=466b5a3fcff884a135079ad5f01d2764" type="text/html" />
	</item>
		<item>
		<title>Goodbye Typo, Hello WordPress!</title>
		<link>http://hcoder.org/2010/01/24/goodbye-typo-hello-wordpress/</link>
		<comments>http://hcoder.org/2010/01/24/goodbye-typo-hello-wordpress/#comments</comments>
		<pubDate>Sun, 24 Jan 2010 17:34:35 +0000</pubDate>
		<dc:creator>emanchado</dc:creator>
				<category><![CDATA[Computers]]></category>
		<category><![CDATA[Meta]]></category>
		<category><![CDATA[Ruby]]></category>
		<category><![CDATA[movable type]]></category>
		<category><![CDATA[rants]]></category>
		<category><![CDATA[upgrade]]></category>
		<category><![CDATA[wordpress]]></category>

		<guid isPermaLink="false">http://hcoder.org/?p=266</guid>
		<description><![CDATA[As I had mentioned several times, I had been frustrated with Typo. Several bugs or misfeatures that really annoyed me, upgrades that had frustrated me, and sometimes the feeling that more or less visible things were broken from time to time in new releases. And while the upgrade problems were mostly because of the need [...]]]></description>
			<content:encoded><![CDATA[<p>As I had mentioned several times, I had <a href="http://hcoder.org/2010/01/03/typo-upgrade-2/">been</a> <a href="http://hcoder.org/2009/02/23/another-typo-upgrade/">frustrated</a> <a href="http://hcoder.org/2008/08/19/sucky-typo-update/">with</a> <a href="http://hcoder.org/2008/08/07/typo-upgrade/">Typo</a>. Several bugs or misfeatures that really annoyed me, upgrades that had frustrated me, and sometimes the feeling that more or less visible things were broken from time to time in new releases. And while the upgrade problems were mostly because of the need to upgrade Ruby gems, still it was something that was inevitable with Typo apparently, so sticking with Typo meant having to deal with Rubygems, which as you may know <a href="http://hcoder.org/2008/11/23/why-i-hate-rubygems/">I hate</a>.</p>
<p>So, after the last upgrade and the frustrations that came with it, I decided to ask around for good blogging software. The main contenders I had in mind were <a href="http://wordpress.org/">WordPress</a> and <a href="http://movabletype.org/">Movable Type</a>. Most of the people who replied talked wonders about WordPress, but I decided to try both. WordPress&#8217; installation was ridiculously easy (I&#8217;m talking about installing my own copy, not opening a blog in wordpress.com obviously) and I had a working blog pretty quickly. Also, at least the first impression of the UI is that it&#8217;s very slick and easy to use. It shows maturity. Movable Type was easy enough to install, although I did have some problems (mostly due to my own stupidity, but still). The first impression was that Movable Type was much &#8220;heavier&#8221; and maybe a bit too much for a single, personal blog. So I decided to go for WordPress, which was the one that I had been recommended by most people anyway.</p>
<p>So, the first thing I had to do was exporting the content from Typo&#8217;s HCoder so I could import into WordPress. I quickly found some <a href="http://snippets.dzone.com/posts/show/3264">script for Typo that would export in WordPress&#8217; format</a>, for easy import. It worked very well, although I did a problem with the tags: they were treated as normal categories, so I ended up with <strong>many</strong> categories and no tags (and a huge, horrible, impossible to navigate sidebar with dozens of categories). I started to look around, and I couldn&#8217;t find a spec for the <em>wxr</em> format. Maybe I was naive thinking that there would be one, but hey. In any case, eventually I figured out that I had to change the:</p>
<pre>&lt;category&gt;rants&lt;/category&gt;</pre>
<p>to</p>
<pre>&lt;category domain="tag"&gt;rants&lt;/category&gt;</pre>
<p>for the tags. The categories had to stay as they were, but luckily for me, all uppercase names were categories, and all lowercase names were tags, so I could do the trick with vim with:</p>
<pre>:%s/&lt;category&gt;\([a-z]\)/&lt;category domain="tag"&gt;\1/</pre>
<p>After that, I could import back all the content, but then I had the next hurdle: the style of the blog. I didn&#8217;t mind if the design wasn&#8217;t exactly the same, but I was used to the old one and didn&#8217;t want to change it too much, so I used the excellent <a href="http://www.opera.com/dragonfly/">Opera Dragonfly</a> to inspect the styles of the old blog, and I slowly copied the most interesting values (colours and font sizes mostly) to the equivalent CSS classes in the WordPress theme. I&#8217;m happy with the result, so I think I&#8217;ll leave it as it is for now.</p>
<p>Last, but not least, I wanted to try to keep the old URLs working. I did two things for this:</p>
<ol>
<li>I added some URL rewrites to keep Typo&#8217;s feed URLs working. However, the Atom ones also redirect to the RSS ones, I wonder if that&#8217;ll be a problem.</li>
<li>I changed the default permalink settings in WordPress so they matched what I had in Typo. Hopefully almost all blog posts will actually keep the URL and the migration to WordPress won&#8217;t be very traumatic. You tell me if I&#8217;ve broken anything ;-)</li>
</ol>
<p>One thing that I don&#8217;t like about WordPress&#8217; blog editor is that apparently it doesn&#8217;t allow you to write in some Wiki-like syntax, like <a href="http://daringfireball.net/projects/markdown/syntax">Markdown</a> or <a href="http://www.textism.com/tools/textile/">Textile</a>. I know Movable Type does have it, but several other things made me stick with WordPress and I&#8217;m happy overall. At least for now ;-)</p>
 <p><a href="http://hcoder.org/?flattrss_redirect&amp;id=266&amp;md5=3b44a41370a570e3adff54e8c2f83ee1" title="Flattr" target="_blank"><img src="http://hcoder.org/wp-content/plugins/flattr/img/flattr-badge-large.png" alt="flattr this!"/></a></p>]]></content:encoded>
			<wfw:commentRss>http://hcoder.org/2010/01/24/goodbye-typo-hello-wordpress/feed/</wfw:commentRss>
		<slash:comments>4</slash:comments>
		<atom:link rel="payment" href="http://hcoder.org/?flattrss_redirect&amp;id=266&amp;md5=3b44a41370a570e3adff54e8c2f83ee1" type="text/html" />
	</item>
		<item>
		<title>Typo upgrade</title>
		<link>http://hcoder.org/2010/01/03/typo-upgrade-2/</link>
		<comments>http://hcoder.org/2010/01/03/typo-upgrade-2/#comments</comments>
		<pubDate>Sun, 03 Jan 2010 20:29:00 +0000</pubDate>
		<dc:creator>emanchado</dc:creator>
				<category><![CDATA[Meta]]></category>
		<category><![CDATA[Ruby]]></category>
		<category><![CDATA[rants]]></category>
		<category><![CDATA[upgrade]]></category>

		<guid isPermaLink="false"></guid>
		<description><![CDATA[I have upgraded to Typo 5.4.1. Partly because of security issues, partly because of new features and improvements. It took me a while, mostly because of stupid Ruby deployment nonsense that makes me even more tired of Ruby as a language for production usage, than I already was. Oh well. One of the most important [...]]]></description>
			<content:encoded><![CDATA[<p>
	I have upgraded to Typo 5.4.1. Partly because of security issues, partly because of new features and improvements.</p>
<p>
	It took me a while, mostly because of stupid Ruby deployment nonsense that makes me even more tired of Ruby as a language for production usage, than I already was. Oh well.</p>
<p>
	One of the most important new features for me in this release was the article preview, which doesn&#39;t seem to work. Or maybe it does, but then support for writing blog posts in Textile seems like it was dropped. Suggestions for other blogging platforms that aren&#39;t a pain to upgrade because of the language dependencies, supports writing in some wiki-like syntax (e.g. Textile or Markdown) and generally works well are <em>very</em> welcome.</p>
<p>
	It seems that everything is in place and working now, but if you see anything misbehaving, please give me a shout and I&#39;ll try to fix.</p>
 <p><a href="http://hcoder.org/?flattrss_redirect&amp;id=82&amp;md5=8273c1f4c688163cc8faace0e614b85c" title="Flattr" target="_blank"><img src="http://hcoder.org/wp-content/plugins/flattr/img/flattr-badge-large.png" alt="flattr this!"/></a></p>]]></content:encoded>
			<wfw:commentRss>http://hcoder.org/2010/01/03/typo-upgrade-2/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		<atom:link rel="payment" href="http://hcoder.org/?flattrss_redirect&amp;id=82&amp;md5=8273c1f4c688163cc8faace0e614b85c" type="text/html" />
	</item>
		<item>
		<title>Watchmen and the annoying ad</title>
		<link>http://hcoder.org/2009/04/01/watchmen-and-the-annoying-ad/</link>
		<comments>http://hcoder.org/2009/04/01/watchmen-and-the-annoying-ad/#comments</comments>
		<pubDate>Wed, 01 Apr 2009 21:37:00 +0000</pubDate>
		<dc:creator>emanchado</dc:creator>
				<category><![CDATA[Other]]></category>
		<category><![CDATA[ad]]></category>
		<category><![CDATA[commercial]]></category>
		<category><![CDATA[films]]></category>
		<category><![CDATA[graffiti]]></category>
		<category><![CDATA[movies]]></category>
		<category><![CDATA[oslo]]></category>
		<category><![CDATA[rants]]></category>
		<category><![CDATA[silly]]></category>
		<category><![CDATA[watchmen]]></category>

		<guid isPermaLink="false"></guid>
		<description><![CDATA[Phew! It has been a long time since I wrote. More than once already, hmmm&#8230;. I went to the movies to see Watchmen. I don&#8217;t want to spoil, but I think it was a very, very good adaptation of the comic book. Actually, I think it&#8217;s the best comic adaptation I have ever seen. And [...]]]></description>
			<content:encoded><![CDATA[<p>Phew! It has been a long time since I wrote. More than once already, hmmm&#8230;.</p>
<p>I went to the movies to see <a href="http://us.imdb.com/title/tt0409459/">Watchmen</a>. I don&#8217;t want to spoil, but I think it was a very, very good adaptation of the comic book. Actually, I think it&#8217;s the best comic adaptation I have ever seen. <em>And</em> I don&#8217;t think Watchmen was particularly easy to get right. <em>And</em> I had just finished reading the comic for the second time just before watching the movie. And yet, I was impressed. The adaptation was really close to the book, and very, very good.</p>
<p>I admit I didn&#8217;t have huge expectations: after <a href="http://us.imdb.com/title/tt0416449/">300</a> (amazing book, silly-although-fun action movie), the &#8220;from the visionary director of 300&#8221; in the Watchmen trailer didn&#8217;t sound particularly encouraging. But I just love Watchmen-the-comic, so I figured it&#8217;d probably be fun to watch. And boy was I right. Not only fun, but very interesting, and even moving at moments (my favourite part of the movie is the story of <a href="http://us.imdb.com/character/ch0060115/">Jon Osterman</a>).</p>
<p>There are a couple of things I didn&#8217;t like (not spoilers, don&#8217;t worry!):</p>
<ul>
<li>The fights were a bit too superhero-ish (people &#8220;flying&#8221; around and such), which made it look a bit silly.</li>
<li>It was a bit too crude and bloody.</li>
<li>Adrian Veidt didn&#8217;t have the massive charisma from the comic. He felt more like an arrogant asshole.</li>
</ul>
<p>Before actually watching the film, though, there were the typical commercials. One of them really upset me, and I thought it was worth a mention. The commercial showed three young lads waiting in a queue, about to enter the U.S. Someone was checking their passports and whatever. The first of them enters and waves at the other two, happy. The second one enters and looks at the last one. The person checking the passports takes a while with the last one&#8230; and finally says some bullshit like:</p>
<blockquote>
<p>I&#8217;m sorry sir, I can&#8217;t let you in</p>
</blockquote>
<p>The first two look at him, confused, looking for an explanation, and the unlucky one looks back with a sad face, like regretting something. Then, the grand finale: some stupid text explains that he couldn&#8217;t enter because he had done something horrible, namely&#8230;. graffiti.</p>
<p>Give. me. a. fucking. break. I&#8217;m tired of all that biased bullshit. It&#8217;s not like Oslo has big problems or anything, but seriously: even fixing the crappy pavement around Grünnerløkka is like <strong>several orders of magnitude</strong> more important than the &#8220;graffiti problem&#8221;. Seriosly, politicians, get a life and do something useful.</p>
<p>Luckily, the film made me forget the ad quickly ;-)</p>
 <p><a href="http://hcoder.org/?flattrss_redirect&amp;id=64&amp;md5=83f6c5621ad5d5333c095a2371c1353f" title="Flattr" target="_blank"><img src="http://hcoder.org/wp-content/plugins/flattr/img/flattr-badge-large.png" alt="flattr this!"/></a></p>]]></content:encoded>
			<wfw:commentRss>http://hcoder.org/2009/04/01/watchmen-and-the-annoying-ad/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		<atom:link rel="payment" href="http://hcoder.org/?flattrss_redirect&amp;id=64&amp;md5=83f6c5621ad5d5333c095a2371c1353f" type="text/html" />
	</item>
		<item>
		<title>Crappy brochure</title>
		<link>http://hcoder.org/2009/01/17/crappy-brochure/</link>
		<comments>http://hcoder.org/2009/01/17/crappy-brochure/#comments</comments>
		<pubDate>Sat, 17 Jan 2009 16:42:00 +0000</pubDate>
		<dc:creator>emanchado</dc:creator>
				<category><![CDATA[Other]]></category>
		<category><![CDATA[brochure]]></category>
		<category><![CDATA[canaria]]></category>
		<category><![CDATA[gran]]></category>
		<category><![CDATA[rants]]></category>
		<category><![CDATA[shoddy]]></category>
		<category><![CDATA[Work]]></category>

		<guid isPermaLink="false"></guid>
		<description><![CDATA[I had this pearl saved since I was on vacation in Gran Canaria. It&#8217;s a perfect example of a shoddy piece of work when you do things quick &#38; dirty, without wanting to spend money or time to do things properly. I obviously don&#8217;t know the circumstances of the company that made this, or its [...]]]></description>
			<content:encoded><![CDATA[<p>I had this pearl saved since I was on vacation in Gran Canaria. It&#8217;s a perfect example of a shoddy piece of work when you do things quick &amp; dirty, without wanting to spend money or time to do things properly. I obviously don&#8217;t know the circumstances of the company that made this, or its employees, but I can imagine.</p>
<p>A bit of context: I was in a very touristic part of the island, and some person handed me a brochure (in English) with information about excursions around different parts of Gran Canaria. I thought it would be a good idea to keep it around, to get ideas about which parts we could see in the next days. However, when we arrived at the hotel and started reading it, we realised how horrible it was. So horrible that we spent some time reading through it, half laughing, half outraged, and I kept it to write about it ;-)</p>
<p>First impression: crappy design and font faces; lots of information stuffed together without order or harmony; horrible wording (<em>bad</em> high-school student level); different writing style in each text; typos, Spanish-like expression, almost complete lack of accents in the Spanish names. Obviously English is not my mother tongue, and I don&#8217;t claim to not make mistakes, but the general quality of this is <strong>really</strong> bad. Some highlights:</p>
<ul>
<li>From the first excursion, &#8220;Grand Tour&#8221;: &#8220;We drive now along de (sic) west-coast up to Agaete, do you know what <strong>Dedo de Dios</strong> means?? The gide (sic) will explain you everything about it. In Agaete we have some time for a small lunch, today we go for fish (meat is possibel (sic))&#8221; and &#8220;This is a verry (sic) nice trip with lots of magistic (sic) views of al (sic) types of rockformations (sic)&#8221;.</li>
<li>The second excursion, &#8220;*Un*discover Gran Canaria&#8221; (emphasis mine), ends with: &#8220;At the end of the day, the couch (sic) will take you back to your hotel&#8221;.</li>
<li>From the third one, &#8220;Las Palmas &#8216;HighLights&#8217;&#8221;: &#8220;[&#8230;] the Museum &#8216;Casa Colon&#8217; (christof.columbus)&#8221;. <span class="caps">WTF</span> is that, his GMail address? Apart from the fact that that&#8217;s not the English spelling for <a href="http://en.wikipedia.org/wiki/Christopher_Columbus">Christopher Columbus</a>.</li>
<li>The fourth one is about a municipality called &#8220;Teror&#8221;. For some reason, they decided to always uppercase it, which leads to this expression jumping and screaming for attention: &#8220;<strong>Market of <span class="caps">TEROR</span></strong>&#8221; (also bold in the original), so easy to misread as &#8220;<strong>Market of <span class="caps">TERROR</span></strong>&#8221;, which sounds&#8230; weird.</li>
<li>The fifth one, &#8220;The Cavehouses (sic) of Guayadaque&#8221;, also has interesting stuff: &#8220;Our last stop will be in the old town of Agüimes, [&#8230;]. Now we turn back, direction Aguimes (sic) [&#8230;]&#8221;, &#8220;[&#8230;] where we have the posibility (sic) for a nice lunch in a typical canarian (sic) restaurant ( entrance musem opcional (sic))&#8221; and &#8220;Its (sic) now time to go back, the beautiful ravain (sic???) of tirajana (sic), with a stop in the old village Fataga, enjoy the amazing views, and please&#8230;don&#8217;t forget your camara (sic)&#8221;.</li>
<li>The sixth has some minor issues, but the seventh (&#8220;Ferry/market Mogan (sic) 2 in 1 excursion&#8221;) is short and just great so here it goes: &#8220;From Playa del Inglés we travel too (sic) the port of Arguineguin (sic) where we take the ferry too (sic) the port of Mogan (sic), better known as little vinice (sic), here you will visit an authentic tradicional (sic) street market&#8221;.</li>
<li>Fast-forward to the eleventh (&#8220;Sioux City&#8221;), which starts strong: &#8220;It is time to go back to your childhood and play cowboys and Indians! Yes I am talking about the famous Sioux City&#8221;. Gotta love the lack of commas. Then it goes: &#8220;You will witness a bank robbery in the wild wild west, with horses, guns, knifes (sic) whips and of course those dancing gids (sic??? wtf?). Whilst feasting on a western buffet and drinking free all night. It&#8217;s a night for all the family&#8230; So go on ride em Cowboy&#8221;. I love the super fancy &#8220;whilst&#8221; mixed with the lack of commas.</li>
<li>Twelveth sets a new standard, and writes everything IN <span class="caps">CAPS</span>&#8230; and of course almost without commas: &#8220;<span class="caps">COME</span> <span class="caps">AND</span> <span class="caps">ENJOY</span> <span class="caps">WITH</span> US A <span class="caps">GREAT</span> <span class="caps">DAY</span>, <span class="caps">KNOWING</span> <span class="caps">THE</span> <span class="caps">MOST</span> <span class="caps">BEAUTIFUL</span> <span class="caps">PLACES</span> OF <span class="caps">OUR</span> <span class="caps">ISLAND</span> [&#8230;]&#8221; (&#8220;<span class="caps">KNOWING</span>&#8221; for &#8220;getting to know&#8221; of &#8220;discovering&#8221;), &#8220;<span class="caps">ENJOY</span> <span class="caps">THIS</span> <span class="caps">ADVENTURE</span> <span class="caps">AND</span> WE <span class="caps">WILL</span> <span class="caps">TELL</span> <span class="caps">YOU</span> <span class="caps">ALL</span> <span class="caps">ABOUT</span> <span class="caps">THE</span> <span class="caps">HISTORY</span> <span class="caps">AND</span> <span class="caps">CULTURE</span> <span class="caps">AND</span> AT <span class="caps">THE</span> <span class="caps">SAME</span> <span class="caps">TIME</span> <span class="caps">YOU</span> <span class="caps">WILL</span> BE <span class="caps">ABLE</span> TO <span class="caps">ADMIRE</span> <span class="caps">THE</span> <span class="caps">WONDERFUL</span> <span class="caps">COUNTRY</span>&#8221; (&#8220;<span class="caps">COUNTRY</span>&#8221; for &#8220;countryside&#8221;, I think) and &#8220;DO <span class="caps">NOT</span> <span class="caps">FORGET</span> <span class="caps">YOUR</span> <span class="caps">SWIMSUIT</span> <span class="caps">FOR</span> <span class="caps">OUR</span> <span class="caps">REFRESHING</span> <span class="caps">SWIM</span> IN <span class="caps">ONE</span> OF <span class="caps">OUR</span> <span class="caps">LAKES</span>&#8221;. I&#8217;m not completely sure about the English terms, but I think in Gran Canaria we only have <strong>dams</strong>, not <strong>lakes</strong>.</li>
</ul>
<p>There is more crap, but I&#8217;m tired of writing and you got the idea already. I think the world needs more QA ;-)</p>
 <p><a href="http://hcoder.org/?flattrss_redirect&amp;id=55&amp;md5=41cb0ab09e497752bb1a464bf42cd025" title="Flattr" target="_blank"><img src="http://hcoder.org/wp-content/plugins/flattr/img/flattr-badge-large.png" alt="flattr this!"/></a></p>]]></content:encoded>
			<wfw:commentRss>http://hcoder.org/2009/01/17/crappy-brochure/feed/</wfw:commentRss>
		<slash:comments>1</slash:comments>
		<atom:link rel="payment" href="http://hcoder.org/?flattrss_redirect&amp;id=55&amp;md5=41cb0ab09e497752bb1a464bf42cd025" type="text/html" />
	</item>
		<item>
		<title>Documentation and wikis</title>
		<link>http://hcoder.org/2008/11/28/documentation-and-wikis/</link>
		<comments>http://hcoder.org/2008/11/28/documentation-and-wikis/#comments</comments>
		<pubDate>Fri, 28 Nov 2008 23:00:00 +0000</pubDate>
		<dc:creator>emanchado</dc:creator>
				<category><![CDATA[Computers]]></category>
		<category><![CDATA[Work]]></category>
		<category><![CDATA[documentation]]></category>
		<category><![CDATA[processors]]></category>
		<category><![CDATA[rants]]></category>
		<category><![CDATA[wiki]]></category>
		<category><![CDATA[wikis]]></category>
		<category><![CDATA[word]]></category>

		<guid isPermaLink="false"></guid>
		<description><![CDATA[After a couple of (unrelated) recent events, I remembered that some/most people use some desktop &#8220;word processor&#8221; for writing and maintaining documentation. After years of working with Wikis for virtually all documentation, I have to say that I don&#8217;t understand why people still use those dinosaurs. Using a word processor for documentation feels so nineties. [...]]]></description>
			<content:encoded><![CDATA[<p>After a couple of (unrelated) recent events, I remembered that some/most people use some desktop &#8220;word processor&#8221; for writing and maintaining documentation. After years of working with Wikis for virtually all documentation, I have to say that I don&#8217;t understand why people still use those <em>dinosaurs</em>. Using a word processor for documentation feels so <em>nineties</em>.</p>
<p>When working in technical teams, I think the advantages of the Wikis are amazing:</p>
<ol>
<li>You know you&#8217;re always reading/modifying the latest version. Uploading to a central server or a shared folder, although theoretically possible (and I&#8217;m sure some people do), I don&#8217;t think it works as well.</li>
<li>You can link all content to any other content (and if you keep all your documentation in the same Wiki, you can link to other project documentation or general company/team guidelines or conventions, for example).</li>
<li>You can keep bits of documentation that don&#8217;t fit in a standalone &#8220;document&#8221;, like collections of small tips, lists of things to take into account when you do this or that, checklists, configuration/code snippets and examples, journals, etc. And of course link all that to any other part of the documentation, as stated above.</li>
<li>You think &#8220;globally&#8221;, in terms of the content, not in terms of &#8220;documents&#8221; that are (usually artificially) independent from each other. Also, it&#8217;s mentally cheaper to browse through wiki pages than it is to browse word processor documents, so the documentation is more visible and more used.</li>
<li>You focus on <strong>content</strong>, not on formatting or the way things are presented. It&#8217;s also easier to keep the same consistent look and feel for all your documentation, if you wanted to change it.</li>
<li>As you don&#8217;t have &#8220;documents&#8221;, just &#8220;documentation&#8221;, people feel free to edit and update it whenever is necessary, instead of feeling the need to ask the &#8220;author&#8221; of each document.</li>
<li>You don&#8217;t need any special program that might not be available in all platforms, or at least not interpret the document in exactly the same way. It&#8217;s also easier to access it from other computers.</li>
<li>Documents don&#8217;t get lost or become obsolete because of the format.</li>
<li>You usually get revision control for free (revision control that makes it trivial to see the whole change history for the documentation, review which exact changes some person has made in a given moment, etc). And if you&#8217;re using a Wiki that doesn&#8217;t support version control, you should use a different Wiki <code>;-)</code></li>
</ol>
<p>Of course, I&#8217;m not saying Wikis are the perfect solution, let alone independently of the team, company, project and context you&#8217;re using them in, but I think in general they are quite superior as technical documentation repository for a software development team.</p>
 <p><a href="http://hcoder.org/?flattrss_redirect&amp;id=49&amp;md5=58fb92791a64cef8c46f322717267dbe" title="Flattr" target="_blank"><img src="http://hcoder.org/wp-content/plugins/flattr/img/flattr-badge-large.png" alt="flattr this!"/></a></p>]]></content:encoded>
			<wfw:commentRss>http://hcoder.org/2008/11/28/documentation-and-wikis/feed/</wfw:commentRss>
		<slash:comments>5</slash:comments>
		<atom:link rel="payment" href="http://hcoder.org/?flattrss_redirect&amp;id=49&amp;md5=58fb92791a64cef8c46f322717267dbe" type="text/html" />
	</item>
		<item>
		<title>Why I hate Rubygems</title>
		<link>http://hcoder.org/2008/11/23/why-i-hate-rubygems/</link>
		<comments>http://hcoder.org/2008/11/23/why-i-hate-rubygems/#comments</comments>
		<pubDate>Sun, 23 Nov 2008 20:10:00 +0000</pubDate>
		<dc:creator>emanchado</dc:creator>
				<category><![CDATA[Computers]]></category>
		<category><![CDATA[Ruby]]></category>
		<category><![CDATA[cpan]]></category>
		<category><![CDATA[packaging]]></category>
		<category><![CDATA[rants]]></category>
		<category><![CDATA[rubygems]]></category>

		<guid isPermaLink="false"></guid>
		<description><![CDATA[I have always thought that systems should be something integrated. Each &#8220;system&#8221; has its own conventions, cultural values, etc. and I think you have to respect that. I believe in the Debian way (adapting programs to an integrated system, not just creating a large collection of packages that are identical to the upstream versions), I [...]]]></description>
			<content:encoded><![CDATA[<p>I have always thought that systems should be something integrated. Each &#8220;system&#8221; has its own conventions, cultural values, etc. and I think you have to respect that. I believe in the Debian way (adapting programs to an integrated system, not just creating a large collection of packages that are identical to the upstream versions), I like to adapt my style of programming to the language (indentation conventions, identifiers, tools for building and testing, etc.), I prefer cross-platform applications that look and feel like each platform they run on, etc.</p>
<p>In the same way, I feel that the mere idea of having a programming-language-dependent packaging system is a broken idea. I <strong>know</strong> it has advantages, and I know that being specific to the language, some things work better or are more flexible, but I just don&#8217;t believe in that idea. Why should I use a different packaging system for certain things just because they&#8217;re written in Ruby? Why do I, as a user of those programs/modules, even have to know that there&#8217;s some Ruby-specific packaging system, that doesn&#8217;t integrate at all with my system&#8217;s packaging system, and mixing both leads to a mess?</p>
<p>Not only that, but Rubygems in particular is quite hostile to repackaging into a <em>platform</em>-specific packaging system. A lot of people <em>only</em> provide the gems for their software, which are harder to work with than &#8220;normal&#8221; tarballs. They also use their own conventions for directories, that break the <span class="caps">FHS</span> (for example) and basically only make sense in the context of Rubygems. In that sense, <a href="http://search.cpan.org/"><span class="caps">CPAN</span></a> is much better (although I think using it for application deployment is a <em>very</em> bad idea, but that&#8217;s a different matter), because at least it installs everything in sane directories, it doesn&#8217;t change Perl in any way, and it&#8217;s not a special <em>format</em>, just a repository of easy-to-install, easy-to-work-with, easy-to-hack, easy-to-repackage &#8220;distributions&#8221;.</p>
<p>Why, oh, why?</p>
 <p><a href="http://hcoder.org/?flattrss_redirect&amp;id=48&amp;md5=9dc1a4817603aa1ba663d5435f92cdfc" title="Flattr" target="_blank"><img src="http://hcoder.org/wp-content/plugins/flattr/img/flattr-badge-large.png" alt="flattr this!"/></a></p>]]></content:encoded>
			<wfw:commentRss>http://hcoder.org/2008/11/23/why-i-hate-rubygems/feed/</wfw:commentRss>
		<slash:comments>3</slash:comments>
		<atom:link rel="payment" href="http://hcoder.org/?flattrss_redirect&amp;id=48&amp;md5=9dc1a4817603aa1ba663d5435f92cdfc" type="text/html" />
	</item>
		<item>
		<title>GPG confusion</title>
		<link>http://hcoder.org/2008/09/22/gpg-confusion/</link>
		<comments>http://hcoder.org/2008/09/22/gpg-confusion/#comments</comments>
		<pubDate>Mon, 22 Sep 2008 20:57:00 +0000</pubDate>
		<dc:creator>emanchado</dc:creator>
				<category><![CDATA[Computers]]></category>
		<category><![CDATA[Debian]]></category>
		<category><![CDATA[Work]]></category>
		<category><![CDATA[gnu]]></category>
		<category><![CDATA[gnupg]]></category>
		<category><![CDATA[gpg]]></category>
		<category><![CDATA[privacy]]></category>
		<category><![CDATA[rants]]></category>
		<category><![CDATA[tips]]></category>

		<guid isPermaLink="false"></guid>
		<description><![CDATA[Today I was playing with GnuPG, trying to add a couple of public keys to an &#8220;external&#8221; keyring (some random file, not my own keyring). Why? you ask. Well, I was preparing some Debian package containing GPG keys for APT repository signing (like debian-archive-keyring and such). The point is, I was really confused for quite [...]]]></description>
			<content:encoded><![CDATA[<p>Today I was playing with GnuPG, trying to add a couple of public keys to an &#8220;external&#8221; keyring (some random file, not my own keyring). Why? you ask. Well, I was preparing some Debian package containing <span class="caps">GPG</span> keys for <span class="caps">APT</span> repository signing (like <code>debian-archive-keyring</code> and such).</p>
<p>The point is, I was really confused for quite a bit because, after reading the <code>gpg</code> manpage, I was trying things like:</p>
<p>gpg &#8212;no-default-keyring &#8212;keyring keys.gpg &#8212;import &#8230;     # Wrong!</p>
<p>But that wouldn&#8217;t add anything to the <code>keys.gpg</code>, which I swear I had in the current directory. After a <em>lot</em> of wondering, I realised that <code>gpg</code> interprets paths for keyrings as relative to&#8230; <code>~/.gnupg</code>, not the current directory. I guess it&#8217;s because of security reasons, but I find it really confusing.</p>
<p>The lesson learned, always use <code>--keyring ./keys.gpg</code> or, better, never use <code>keys.gpg</code> as filename for external keyrings, but something more explicit and &#8220;non-standard&#8221; like <code>my-archive-keyring.gpg</code> or whatever.</p>
 <p><a href="http://hcoder.org/?flattrss_redirect&amp;id=41&amp;md5=e0b82264eeee5bb0d363405f10f57861" title="Flattr" target="_blank"><img src="http://hcoder.org/wp-content/plugins/flattr/img/flattr-badge-large.png" alt="flattr this!"/></a></p>]]></content:encoded>
			<wfw:commentRss>http://hcoder.org/2008/09/22/gpg-confusion/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		<atom:link rel="payment" href="http://hcoder.org/?flattrss_redirect&amp;id=41&amp;md5=e0b82264eeee5bb0d363405f10f57861" type="text/html" />
	</item>
		<item>
		<title>Sucky Typo update</title>
		<link>http://hcoder.org/2008/08/19/sucky-typo-update/</link>
		<comments>http://hcoder.org/2008/08/19/sucky-typo-update/#comments</comments>
		<pubDate>Tue, 19 Aug 2008 21:19:00 +0000</pubDate>
		<dc:creator>emanchado</dc:creator>
				<category><![CDATA[Computers]]></category>
		<category><![CDATA[Meta]]></category>
		<category><![CDATA[design]]></category>
		<category><![CDATA[programming]]></category>
		<category><![CDATA[rants]]></category>
		<category><![CDATA[typo]]></category>
		<category><![CDATA[upgrading]]></category>
		<category><![CDATA[woes]]></category>

		<guid isPermaLink="false"></guid>
		<description><![CDATA[The other day I was talking about upgrading Typo. The update itself went well, true, and the site was up and running without too much downtime, but then I started using it again&#8230; and I have noticed two things so far (both about writing posts) that I really dislike: First, the good old editor is [...]]]></description>
			<content:encoded><![CDATA[<p>The other day I was talking about <a href="http://hcoder.org/2008/08/07/">upgrading Typo</a>. The update itself went well, true, and the site was up and running without <em>too much</em> downtime, but then I started using it again&#8230; and I have noticed two things so far (both about writing posts) that I really dislike:</p>
<p>First, the good old editor is not there anymore: the Typo editor used to be really good, because on the left hand side you had a very reliable and easy to use textarea with Wiki syntax (you can choose which exact syntax you want), and on the right hand side you had a &#8220;live preview&#8221; of your post, automatically updated with Ajax, that showed you how the post was going to look like. Well, that&#8217;s <strong>gone</strong>. Now there are two options: some retarded <span class="caps">WYSIWYG</span> box, that I tried to use and failed, and some good old textarea&#8230; <em>without the damn live preview</em>. That <strong>sucks</strong> big time, because there is <em>no other preview</em> (that I have seen: <strong>please</strong> enlighten me if there is indeed one), so I just blindly write things in a Wiki format, and <strong>hope</strong> that it&#8217;s going to look OK when I press &#8220;Publish&#8221;.</p>
<p>Second, I was playing with the Wiki format for the articles, and I changed it to &#8220;Markdown&#8221; (I always mix &#8220;Textile&#8221; with &#8220;Markdown&#8221;, and never remember which is which; the one I prefer is Textile). After I hit &#8220;Save&#8221;, not only the next article was parsed in Markdown format by default, but <strong>every single blog post</strong>. It&#8217;s like, you select the parser the system is going to use to interpret your whole blog. How retarded is that? Once you have written posts, it doesn&#8217;t make sense to change their syntax (unless you do it manually editing the post itself). <strong>Clearly</strong> the format is a property of each blog post, not of the whole blog installation.</p>
<p>Not everything is bad though: it seems that now you finally have a &#8220;Draft&#8221; concept, so I can start writing a blog post and just save as a draft, instead of unticking the &#8220;Online&#8221; property and saving as a normal post. Also, the drafts are saved <em>automatically</em>, so I don&#8217;t have to remember to hit &#8220;Save&#8221; from time to time just in case the browser crashes or I hit something stupid and erase the contents of the post. Yay for that.</p>
 <p><a href="http://hcoder.org/?flattrss_redirect&amp;id=38&amp;md5=b284396e75d48636ba7cd3f7a7ec5828" title="Flattr" target="_blank"><img src="http://hcoder.org/wp-content/plugins/flattr/img/flattr-badge-large.png" alt="flattr this!"/></a></p>]]></content:encoded>
			<wfw:commentRss>http://hcoder.org/2008/08/19/sucky-typo-update/feed/</wfw:commentRss>
		<slash:comments>4</slash:comments>
		<atom:link rel="payment" href="http://hcoder.org/?flattrss_redirect&amp;id=38&amp;md5=b284396e75d48636ba7cd3f7a7ec5828" type="text/html" />
	</item>
	</channel>
</rss>

