Hostile to Documentation?

I think every developer has had that feeling when they discover a project on GitHub that seems like the answer to the problem they are trying to solve. Unfortunately, many times this project turns out to be either undocumented or minimally documented and the experience ends in frustration. Yesterday I released an article titled “Your Open Source Project is Considered Harmful” (fwiw, the title is meant to be cheeky though not everyone took it that way) that discusses the huge abundance of undocumented and poorly documented code on GitHub. The goal of the article is to ask developers to think...…

5 Common Problems with Technical Articles

I read and edit a lot of technical articles - generally written by developers for developers. In the past, I wrote up some guidelines for making your technical content better. This time, I want to take the opposite angle and focus on some mistakes I see all too frequently. …

Best Music of 2015

There was a ton of great music this year - almost too much for me to cover. Here are six of my personal favorite songs of the year (yeah, it’s a well known fact that I am a sucker for a female vocalist…and this list is proof). Shura - 2Shy Shura is the stage name for British singer, songwriter, producer Aleksandra Denton. I discovered her only recently via a song she released last year called Touch. While that song is excellent, 2Shy, which was released in April this year and is part of her “White Light” EP, is even better....…

Enough with the Developer Surveys Already

The developer survey seems to have become a mainstay of technical blogs lately. I don’t mean to pick on anyone in particular, but the problem is, almost every one does not pass the eye test. This isn’t surprising when you think about it though. There are several problems with these surveys that prevent them from really being representative of the community they want to represent. …

Is the Native Mobile App Ecosystem Worth Saving?

The native mobile app ecosystem is facing some major challenges. Some have even argued that it is in need of saving. Before we get there, though, let’s examine what the problems are. About 5 years ago, we were in the middle of a modern “gold rush” with companies eager to establish a presence in the app stores. The iOS App Store opened in 2008 and it had already reached its 10 billionth download by 2011. The Android Market (now called Google Play) reached its 10 billionth download in late 2011 as well, having launched in 2008 as well. It’s no...…

Some Advanced Jekyll/Liquid Template Techniques

Generally speaking, Liquid templates for Jekyll are pretty easy to create - Liquid is a powerful templating tool and offers a large number of helpers and formatters to get complex tasks done. However, recently I had the opportunity to build a site that required me to use some techniques I’d never needed before with Liquid and Jekyll. …