Skip to main content

The art of writing

I've always considered myself more of a coder than a documenter (if there is such a word). I like writing codes but I hate writing about them. I do write about it once in a while in a blog or something if it's something especially hard and I might have to refer about doing it again but usually I'll just file it in my head as "ooooh.. I can look it up later if I REALLY need it". So some of the stuff that I really hate to write up are user manuals and requirement specs.

Now I've been burned enough times to know that requirement specs are really crucial to a successful software project. If the user does not know what they want, then you'll soon be sucked into the black hole of "user wants" pretty soon and it would take a whole lot of thick face justifying yourself just to save your sanity much less the project. But even then, I'm still very much unmotivated to do it. One of the reasons is that it is so bland and boring. Boring to write, boring to read. And finally nobody would refer to it. But recently I read that you should strive to make it enjoyable to read. Maybe even funny. And I was awestruck. A funny user requirement specs, that'd be awesome. :)

If you know me personally, I think you'd agree I try very very hard to be funny. Is it difficult to be funny? Hmmm.. I practice a lot and still sometimes it's just flat out come out flat. So I guess it's pretty hard. But you know what's even harder? Just becoming consistent in the discipline of writing. Ok.. maybe for me at least, being consistent in being disciplined in anything at all.. :P

I have this blog right here, and I retain the rights to say whatever I want on it, and I could practice my writing skills every single day if I wanted to, but I know that would never happen (yeah... I hear your sighs of relieve for not needing to read my rants everyday). Because I know I'd never be able to stick to it. Maybe once a week, maybe, but anything more than that would be nigh impossible.

You know what's another funny thing about writing in blogs? I used to write without a care in the world because I know nobody is going to read it. But since I know people know of it, and read it, and some even kind enough to leave comments in it, my mindset changed. I write as if I'm writing for an audience. Oh I know it's all my fault, that it is all in my mind, but I can't help it. That's how I feel about it. I don't think it's a bad thing, only that it sometimes makes me take a longer time to write it up. I think more about the words and composition, think more about how the references have to be right, think more about making it acceptable. So in the end, all the speed you get practicing touch typing for hours and hours becomes moot because you just sit there in front of the monitor for 5 minutes to write a single sentence. Of course once the idea comes rampaging through you're glad you can type pretty fast, but most of the time, you're no faster than a 'hunt and peck'er. Oh well... that's all for now I guess. See you again next week, same time, same place.. ta.. ta.. :D

Comments

Popular posts from this blog

haproxy on Centos 7 with SELinux

Setting up haproxy and varnish with reference to the configuration from these sites: http://sharadchhetri.com/2014/12/20/how-to-install-varnish-4-version-on-centos-7-rhel-7/ https://www.upcloud.com/support/haproxy-load-balancer-centos/ And finally can access plone on the server. But when I check the haproxy status, only client1 can be accessed. All other clients were down with general socket error, permission denied. Googling a bit I finally found out it was due to SELinux. Refer to this page: http://stackoverflow.com/questions/26420729/haproxy-health-check-permission-denied With the solution from that page, I installed policycoreutils-python and tried to run the command given: semanage port --add --type http_port_t --proto tcp 8081 But that command failed with the error that the port was already defined. When I looked it up using: semanage port -l | grep 8081 It belonged to some other type (transproxy_port_t). When I tried to delete the type using: semanage port -d -t transpro…

Installing Centos 7 on HP G7 Server

When I first initially tried it, the installer cannot detect any local hard disk to install to. After much googling found out that it was because a certain driver for the Smart Array Controller is no longer available on Centos 7. To allow for use of the new driver on old hardware, you need to enable the option. Once the DVD has booted and on the first menu screen, highlight the first option and then press tab which would bring you to a command line where you can add additional parameters to boot. Add the following parameters: hpsa.hpsa_allow_any=1 hpsa.hpsa_simple_mode=1 And then press enter to boot. You should now be able to install as you wish. After installation, on the first boot, make sure at the menu, press 'e' to edit the parameters and add them again. Then once booted, go to /boot/grub2/grub.cfg to permanently add the parameters to the menu. Refer to http://serverfault.com/questions/611182/centos-7-x64-and-hp-proliant-dl360-g5-scsi-controller-compatibility and it&#…

Me and my sleep apnea

I have been suffering from sleep apnea for quite a few years already. It started to show when I was still with OSCC some 6 years back when I would sometimes "accidentally" sleep at my cubicle. Early on I just dismissed it as because I was growing fat (we ate a lot at OSCC.. :P and I barely went anywhere except my cubicle) and also because of babies. Oh babies.. those cute little things that keeps you awake at night so that they can be so cute and charming when your friends and relatives come over the next day. So it was dismissed. Later on I got more and more used to sleeping at work, started associating it with my lack of motivation and sometimes feeling of downright depression. And I kept growing fatter and fatter, which I assumed was the reason why I was getting more and more tired.

But then around 2 years ago a friend of mine suggested maybe I've got sleep apnea. And a few other people suggested I go to a sleep clinic and all that. Put it off for quite a while. Until…