How to make commenting code fun?

Comment, comment comment. It must been a hell of a side job as a programmer or similar to do. We are programmers, we writes code, not documents, yada yada..

Well, that is what I thought in the first place.


Commenting is very very important in a long term or growing project. No matter how beautiful and readable your ‘self-documenting code’ will be. Why? The key is again, why?

Your code already does what it does, tell the computer to do things, and tell you what it does. However, why the code is even there in the first place? Why?

The first step to make documenting and reading it as a fun thing is, make it tell you why the code is there.

For instance, you have a function that writes to a configuration file on a Linux hosting server with only FTP access without SSH (I know it sucks, consider alternatives including DigitalOcean for VPS-like hosting or Bluehost also Dreamhost for SSH access).

An example comment for this scenario is – the server doesn’t have SSH access to execute Linux commands, so we implement this to write the code invoked from the execution of the web app.

And there ladies and gentleman, will make your life easier by commenting why instead of what.

Don’t repeat the code, assume the audience already understand the language and algorithm, and it is their fault for not taking enough time and effort to understand it (unless you writing clever code and cryptic algorithms, you are to blame instead).

Other keys like enforcing the use of good grammar and simplicity of the commenting language is also important too, but don’t let that stopping you from commenting your code if you are not fluent at the target language.

You are an awesome person for reading this. Why? because you have the passion to look the answer, to be a better developer, thus making your life and others easier to make reading codes and documentations an enjoyable experience.

Protect it, live it, love it, soon it is nothing for you, but a good habit.

Perl, Perl 5, Science, Programming/Coding

DevOps in Perl? Consider Rex.

Rex is a ‘Deployment & Configuration Management’ also knows as DevOps framework. Interestingly, it is in Perl, for Perl language. There is Ruby’s Chef & Puppet, Python’s Ansible, and Perl also has those frameworks too, but here I’m pointing to Rex because it will be much more familiar to Puppet, Chef and Ansible users in syntax and workflow perspectives.

Why do this in Perl?

Perl itself has been designed and well known for its powerful features on sysadmin tasks. Combine with this kind of framework, you are just gonna be much happier on getting the job done. Fortunately, if you are trying to opt to write ‘maintainable and long-term modules/scripts’ without using Rex, Modern Perl as a guideline should help you doing so, and CPAN with much lesser code in general.



Learning to Code

Coder Wong

After a month studying programming for 8-12hrs per day. My mind finally gave in the last 2 days. I think I woke up on the wrong side of the bed. Couldn’t think properly and had to reset. Currently learning JavaScript and it’s a pain in the ass but I will never give up! Now, I am revitalised  and back at it again!

Currently following Javascript Is Sexy site.

Happy Easter Everybody!

We are not defeated by adversity but by the loss of the will to strive. However devastated you may feel, so long as you have the will to fight on, you can surely triumph.

View original post

Perl, Perl 6

Perl 6: Rakudo Linux Native Packages

Installing Rakudo on Linux can be a dissapointment. Either from compiling from source, or install the old ‘rakudo’ package from our Linux distribution repository.

Not anymore.

nxadm from Github has packaged the recent if not the most latest Rakudo Linux natives packages for Debian/Ubuntu and RPM based system (centos/fedora/opensuse).

A retweet –

Download your native linux packages here