h4ck3r+=boi v 2.0

View this repository in my editor, and I don't care about keeping it

Tue, 14 May 2013 12:58:09 -0400

My current job has me doing a lot of node.js. The documentation story in most of the community is very much “read the source”.

This is a little bit of a contrast to the Rails community, where, even in Rails 1.2.3 (when I entered the scene) I rarely had to dig through source code to find an answer to a question.

Anyway, I find myself reading a lot of node package code. Viewing the code directly on Github is OK for a simple package, but I usually want to be in my editor.

I also want these packages I download to go away, eventually. I could use Hazel, or I could shove things in /tmp/ and let the system clean it up eventually.

So I wrote a script:

This script is great coupled with LaunchBar’s Unix Executable support. I can select this script from my Launchbar, SPACE, paste a git clone path, option-return and half a second later I have the project in my editor (BBEdit).

If the package means my needs I may add it to my node project. Once I do that viewing the code is just a node edit away, but when trying to choose between 2 different-but-providing-similar-functionality packages, making a temporary clone is great.

Open Source

Wed, 10 Apr 2013 12:04:38 -0400

I often find myself doing open source work. Mostly this is small improvements to already existing projects, but sometimes there are projects I’ll open source from scratch.

However, most of my work is using an open source project, and find a way to improve it. This improvement could be a bug fix, or better error messages, or improvements I’ve needed to get my job done. Sometimes clients even pay me to implement some features in an open source projects.

For the last 4 years or so most of my contributions have been via Github.

Github works by people “forking” (copying) an open source repo to their own user account, making changes, then submitting those changes back to the main project repository. This works great, except sometimes people fork projects to their user account simply to have a copy of the code.

So, you could have an account with a ton of forks - as a person browsing the account you don’t know if they’ve made contributions to the project or if they just want a copy of the code for their own.

Projects I’ve contributed to

I don’t know how to solve this problem, but I do know that I can list projects that I’ve made non-trivial contributions to, and where my code was accepted:

My Github page shows other contributions to the open source community in large: examples, tools, things for text editors, and some original libraries of code. However, I really do enjoy the times when I can contribute a small change to an open source project that makes everyone’s life a little better.

My own projects that I’ve worked on

In addition to improving other people’s projects, Github also lets you publish your own projects. Most of mine are small projects, but I have published a few larger projects:

the school_days gem: because some days you need to know if Date.today.school_night?
the delegate_presenter gem: a gem based on Avdi Grimm’s thoughts on presenters. This was before the release of Objects on Rails.
RunningBalance: a checkbook example app with API and mobile browsing considerations
ChatChat, a Meteor play project: woh, I played with Meteor once

(natural) Handwriting Recognition on your iOS device

Sat, 23 Mar 2013 11:44:07 -0400

Goal: Creeping towards the paperless lifestyle

I’m trying to get into the paperless lifestyle this year. I’m making small changes to facilitate this.

I keep a paper notebook for scratch writing while I work. Mostly the notebook contains things I need to remember for the next 5 minutes, but can forget afterwards. Sometimes it contains more permanent notes: TODO times, thoughts, things to research

I want to be able to make these thoughts paperless. Yesterday I stumbled on a workflow that works for me.

My Workflow

Use MyScript Memo - this will do handwriting recognition and give you the text to be copied.

Send it over to the Mac via PasteBot, or save it via a Dropbox editor

But it can not do handwriting recognition on pictures

So when get idea need to save grab my iPad and stylus and enter it!!

Questions and Answers

Q: Why not Evernote?

A: I want to get the translated text, so I can make corrections to it. Evernote translates the text but I can’t go back and edit the guessed at text. I can’t even export the text: exporting the image gives me an XML document with the image data and each translated word in it’s own XML element with coordinates. I can see why this (for highlighting the text on the image), but seriously I don’t care.

Between my bad handwriting and all the technical terms I use, I really need to be able to go back and correct my text.

Also, with this workflow, the only thing that matters is the text: I don’t care about the .jpg of a picture of my writing. Evernote sees the picture as the thing that has text metadata - I want the text as the thing, with the image being metadata.

Q: Why MyScript Memo?

A: I want to be able to handwrite my notes THEN trigger recognition. I don’t want to fight with computers when I’m taking notes in a meeting.

I also want a full page to write on - not just some small 3”x3” space at the bottom of the screen. I want a notebook page that works like a notebook page in the real world.

Q: What sucks about MyScript Memo?

A: I want a bigger digital canvas. Infinite Sketchpad is awesome at this, but there’s no recognition. But Myspace Memo I can get about half a page of physical notepaper (I rewrote some notes I had laying around) so I guess that’s OK.

I believe some of these concerns are addressed in another MyScript product: MyScript notes mobile. While I get a new iPad I’ll try it out (I have an iPad 1).

I’ll probably still use Infinite Sketchpad when I’m mapping out processes or code or something.

MyScript Memo seems a little slow on my iPad 1, but is quite snappy on my iPhone 4S. I’m looking forward to when I upgrade my work iPad.

Q: But why do this in the first place? Why write something?

A: when I’m in a formal and scheduled meeting I will often take notes on my computer. I have a special document for these notes so this has become second habit to me. However there are two places where I want to use handwriting:

Random thoughts I have while working on something. I normally put these ideas in my scratch notebook - a 8.5x11 school notebook - but now I can put them in my iPad without swithving modes from “writing with pens on paper” to “pull up my notes file and start typing.” I’m aiming for low friction data entry.
I can write faster than I can type on the iOS keyboard

I’ve recently purchased a Bluetooth keyboard to try and fix issue 2, but that’s useful when I’m writing an important email on my phone or writing text longer than a tweet.

It’s still early in the process - it’ll be another week before I know if I can stick with this workflow. I use my iPad to read technical books/PDFs, sometimes as a fourth screen, and as a tool when I’m brainstorming at my whiteboard. I look forward to seeing how handwritting turned into searchable text changes how I work

We need to celebrate those with 20 years experience

Thu, 24 Jan 2013 19:06:52 -0500

A recent tweet by a SF tech recruiter put down those with 20 years experience as “[it]… only means you’re forty”

Instead of decrying 20 years experience (“Go home, old man!”) we should celebrate it.

Because 20 years experience as a computer programmer means:

20 years of too much stress (At least once a year or so I’m on projects that require me to work at 150% capacity for 3-5 months).
20 years of late projects being “solved” by adding more people, or (better yet) adding more features.
20 years of weekly or biweekly drama, either in your development community of choice, or internal company drama.
20 years of explaining to your new manager (who used to be a secretary, long haul truck driver, or sales person) how software development works and how to manage a dev team.
20 years of trying to follow “just make it work” orders from a manager, when the technical debt of the codebase fights you every step of the way (while said manager breaths down your neck for status updates).
20 years of blame.
20 years of fighting bugs that happened when you upgrade from one version of something to the next.
20 years of dealing with ever changing (potentially contradictory!) demands.
20 years of software cycles (server -> desktop -> server ->…)
20 years of refining requirements into something that can be implemented.
20 years of too many deadlines.
20 years of job requirements that boil down to “want 25 year old willing to work for peanuts and move to San Francisco”.
20 years of explaining things and getting rebuffed because the manager “knows better”/thinks you are just being cranky/is “willing to take that chance”/tuned out after you said the word “problem”.
20 years of explaining that lines of code is not a good productivity measure (nor is individual completed agile story points per iteration, or pretty much anything else).
20 years of dealing with cranky nerds (who are sometimes cranky at you)
20 years of learning to dealing with, and questioning, recruiting pitches.

If you’ve been programming for 20 years you’ve seen all of these things and probably much more. Even if you’ve been working away in some state’s IT department, migrating some legacy system from Cobol to Java for the last 6 years your experience is still valuable. Because you’ve seen it all before, and picked up programming languages like normal people pick up how to use applications.

Managers and recruiters: if you can keep your ego in check a little bit, these people can be awesome to have on your team. Why? Because:

They know what’s going to happen after that “crunch” weekend of people pulling 20 hour days for 3 days straight
They know that your application internally is a buggy version of half of a 50 year old programming language
They can sometimes take a super hard problem, solve it and prove the solution by relational calculus, or graph theory, or other really hard math.
They are probably more willing to speak up than the young guns on your team.
They’ve seen many things before: “Oh, reactor pattern framework? Oh, been there done that, 15 some years ago!”
They can sometimes manage working on projects with 3 near-simultaneous deadlines.
They probably have fulfilled more roles than just developer: product development person, client relations, recruiting, evaluating new hires, coach, manager, QA tester, conference organizer, salesman.

While years of experience isn’t a great measure of how good a programmer a person is, you know the person has been around the block and (probably) experienced the majority of things on this list — they certainly deserve better than, “get off my lawn, old man!” that the recruiting/startup community seems to exude.

My new IPad stand. Yes those are eraser covers. Works pretty...

Tue, 18 Dec 2012 13:21:20 -0500

My new IPad stand.

Yes those are eraser covers. Works pretty well. My iPad case has good landscape support but not portrait. Yet I was reading a portrait document.

Why Divvy Sometimes I want a set of windows regularly across the...

Fri, 02 Nov 2012 14:04:00 -0400

Why Divvy

Sometimes I want a set of windows regularly across the screen, and sometimes I want the ability to resize my windows in arbitrary (but common) sizes.

With Divvy if I really want to create a 1 row size window in the middle of the screen, for Bog knows what reason I can. I have yet to see this ability in other “tiled window managers”.

With Divvy I can reposition and resize a window with a simple drag. I like it.

So, what do you want to do now?

Title my windows so there is no space left on the screen. This is partially so I can see everything at one time and be efficent. It’s also partially a work around around OS X’s fucked up desktop picture “management”, but whatever. (Seriously, try setting a desktop picture across spaces and with a 2+ monitor setup. It’s impossible.)

My Divvy Setup

Pictures of my Divvy setup are here.

I have a Microsoft 4000 with a full size keypad so I’ve set up these Divvy shortcuts to be activated via the numpad.

I also have enough oddball shortcuts to remember on my system, so these are not global shortcuts. I first bring up Divvy (Control-Shift-Space for me) then hit 9 on my numpad. Namespaces are good - let’s do more of those!

What this results in

I can quickly take two windows and tile them side by side down the full length of my screen.

I can quickly take a window and resize it to take up the top or bottom, left or right, side of my screen. I can go from “two full length side by side” windows to “four quadrant windows” in 3 seconds.

I can also mix it up: I often have 2 half length windows open on the left and one, full length, window open on the right.

Why Not?

Slate? When someone writes a 100 page PragProg book on it I’ll look into it. Trying to understand Slate I’m reminded of the last time I tried to look at X11 configure files.

Size-Up? I like to have the option to create arbitrary sizes. While my standard sizes are (now) 80% of my window management needs sometimes I want something custom.

Moom? Same thing: no arbitrary sizes.

Will Programmers continue to have such high wages? (TL; DR: YES)

Sun, 28 Oct 2012 17:49:20 -0400

Yes, because there’s always some new thing that’s super hard. No matter how much we advance the craft there’s always a new challenge in front of us, no matter if we conquered the previous challenges or not.

Take a flip answer to that question from various eras of computing:

1970s: “Yes, because structured programming”
1980s: “Yes, because event loop and/or graphical interfaces”
1990s: “Yes, because networking”
2000s: “Yes, because pointers”
2010s: “Yes, because concurrency and or asynchronicity

I can imagine the following answers for the next few decades:

2020s: “Yes, because gestures/motions”
2030s: “Yes, because genetic programming”
2035: “Yes, because maintenance programming”
2040s: “Yes because damn stupid AIs”

So yes, I see the learning curve of programming continuing to be a hocky-stick like curve. Yes, it’s relatively easy to teach yourself some HTML and Javascript and build something, then things get harder and harder as you learn more and more. Even if your able to do more and more with a lower and lower skill level there will always be hard problems to solve that need an experienced programmer, and that means well paid.

And this just rounds up the technical reasons. We’ll always have people who want software built but don’t know what they want; processes that - once you dig into them - become more and more complex; and companies that want to “push the edge of what tech can do”. These people problems - that have been the same since the early days of computing - won’t be going away.

Why "just teach the unemployed to program" isn't a good answer

Mon, 01 Oct 2012 23:29:48 -0400

I hear this argument a lot:

Oh, you’re unemployeed or can’t find a job? Just learn computer programming - I hear Microsoft is gagging for people.

As a professional computer programmer, let me weigh in:

I spent 2 years during high school learning to program after school. I started consulting part time during my freshman year of college for a local programming consulting shop. The first year or two at that job I knew very little (looking back on things now), struggling to learn the trade. I’m glad my employers were OK with that.

Fast forward 4 years, and I started my own consultancy business out of college. Doing computer programming consultancy is hard: in addition to having technical chops you also have to do project management, manage cash flow, deal with clients who fight you about money, know basic accounting, you name it. In my own practice there were a lot of years that were “famine” years, and only a few that were “feast” years.

So maybe you think that you can get a job as a programmer with a startup, because startups are what everyone thinks about now. In my experience you need two things going for you to get a job at a startup: 1) living in SF or NYC and 2) having 2-3 years of professional experience in their language of choice. If you don’t have both of those things the pickings are pretty slim.

The thing about startups is because the team size is so small they can’t (or don’t think they can) deal with bringing on a newbie programmer and the slower output they will have.

Please don’t do DevBootcamp or CodeAcademy and think that you can put our your consultancy shingle, working for clients directly. If you really want to go that route find a more experienced freelancer to subcontract with for a year or two, and learn from them.

In one way, the world of web development is easier than the programming world I grew up in (writing C and C++ programs for desktop computers), and perhaps with laser focus on web development you could be a good developer in 6 months. HungryAcademy thinks it can train people to do that, and I have seen amazingly talented people go far with very little (comparatively) training. Then again, there’s at least 4 languages to any moderately complex website (CSS, HTML, JS, and a server-side language), so there’s a lot to cover.

But certainly it’s not a matter of just picking up “Learn Web Development in 24 hours” and a day later being able to charge clients $100/hour for websites. Your looking at half a year at least, if not 2 years at least before companies take you seriously. And probably 3 or 4 years before you really should be taking on clients yourself.

And this is assuming you have the personality and passion for programming. Having tried to train a number of people to be programmers…. it takes a certain type of person to be really good. I’m sure this is as true of other fields as it is of say the Marines.

So sure — certainly if your unemployeed and looking to get an edge up and make a long-term investment in yourself (or just learn something fun!) maybe spending 10-30 hours a week learning programming (between job searching) is a good idea. Maybe in 6-12 months you can make something interesting that people like or think shows enough potential that they’re willing to take a chance on you. But it’s not a panacea.

Especially not when applying to Microsoft, where they want the best of the best.

Replicating Github Launch with Launchbar (well, almost)

Fri, 28 Sep 2012 11:23:03 -0400

Github Launch is pretty cool - a command line interface for Github.

There are two things bad about it:

It’s dog slow on Firefox
It’s entirely Javascript based - I can’t build a tool that sends a command to Github launch outside the browser.

I worked around issue one by typing my command in another window, pasting the result into Github Launch, then hitting return. This kind of sucked, but whatever.

Today I realized that mostly the Github launch commands were mostly just a clean interface around the RESTful URL structure of Github.

So I wrote a search Template for LaunchBar.

The search template looks like:

http://www.github.com/*

It does require a slightly different syntax than Github launch, but it’s also super easy.

Here’s how I use it:

Type: “Github” in Launchbar
Press spacebar to trigger the text input field
type rwilcox/github_my_activites
Press return, be taken to the appropriate repository.

Now, this doesn’t provide tab completion like the Github Launch bar, but tab completion didn’t work for me anyway (dog slow on Firefox).

Embedding images into Github Tickets

Thu, 27 Sep 2012 18:15:22 -0400

It’s hard and annoying to embed images into Github Markup renders.

The great thing is that since everything in Github is markdown, this trick will work everywhere.

The trick is to use an external host to host your images, then link to them by putting a ! in front of a normal Markdown link statement.

But, ugh, external host, right?

Here’s how to do it step by step:

Put the image for Github inclusion in your Dropbox
In the Finder (not PathFinder) right click the file and choose Dropbox -> Share File
Close the share web dialog that your browser opens and copy the URL
Add ?dl=1 to the resulting link

I like to keep my things out of the public folder, so I just use this basic sharing feature. However, I can’t script away the annoying part as apparently part of the link is link specific, not user specific. Source: Scroll down to the ‘for our advanced users’ section of this Dropbox tech note

Alternative Way

If you have your own web space there’s the awesome Automated Transmit Uploader on Github. Although part of me would rather use Dropbox for this… MAN this workflow is really easy.

BBEdit has this useful feature: it will strip whitespace added...

Thu, 27 Sep 2012 09:19:00 -0400

BBEdit has this useful feature: it will strip whitespace added to end of lines OR it will remove all the whitespace from lines that are *just* whitespace.

This setting is at BBEdit -> Preferences -> Text Files -> Strip trailing whitespace.

Most of the time I have this turned on because most of the time I’m writing code in BBEdit.

Except, there are some languages (programming languages and markup languages like Markdown where whitespace is significant.

We can customize BBEdit’s behavior per language via the Languages preferences item. Select your language from the Custom Language preferences, as shown in the image.

You can set language level defaults for pretty much everything text related. What we’re interested in is the Files tab and the Strip trailing whitespace checkbox.

Now, as long as your language in the BBEdit document is set to Markdown it will no longer strip whitespace

Searching your Mutt mail on OS X

Sun, 16 Sep 2012 21:03:32 -0400

I switched to Mutt about a year ago. Mutt is pretty good, but there are a lot of convenience that you give up.

One of these conveniences that you give up with out-of-the-box Mutt is really good, inter-mailbox searching. Sure, you can use a quick search feature to find messages in the current mailbox, but sometimes I’m not sure which mailbox I put my mail.

(You see, I organize my mail in an old-school one-folder-per-topic method)

Prerequisite: Use Maildir, not mbox

For any of the techniques I talk about to work you’ll need to be using Maildir, and not .mbox files. Here’s how you do that:

Use a tool like mb2md to do this.

You’ll also want to strip the leading dot from the generated file names (well, at least I did). See a bash script that does this OR make the change to mb2md directly.

The leading dot is not just annoying (“Where did all my mail go!!!” inducing) but Spotlight won’t index files that begin with a dot.

Wait, Spotlight?!! Yes

Search the OS X way: Spotlight

Now that you’ve used maildir to categorize these messages you can search for it via Spotlight.

The bad thing is that Mutt saves its mail messages with not-human-readable names, so when you do find some messages you’re looking for you don’t really know which exact message is the one you’re looking for.

Enter QLStephen: a QuickLook plugin that allows you to look at plain text documents.

I want to find only email messages, not my search term in other documents!!!

HoudahSpot lets you save a search template. Thus you can create one for email. Here’s mine:

Text Content contains (whatever)
Where: ~/Mail

HoudahSpot is now what I use for searching mail.

Search the Unix Way: notmuch

If you don’t like Spotlight, or run your mail on Linux, great. There’s a tool called notmuch that is a mail indexer which may work for you.

There’s an awesome blog post: Mutt mail indexing on steroids! that I was working through before I found that Spotlight works.

Regardless, notmuch doesn’t support .mbox files, something I ran into early in my testing.

Forwarding sitename.dev to a remote host (for Rails)

Mon, 20 Aug 2012 10:06:10 -0400

I do all my Ruby on Rails development with Vagrant, keeping separate virtual machines for each project I may be working on.

I use SSH magic to forward the proper ports up to my server. I’ve been using this setup for 18 months now, typing in localhost:3001 to visit my Rails server on my development machine.

Enter pow: pow’s goal is to make it really easy to visit a project server on your local machine: type myproject.dev into the browser and Pow finds myproject, boots the Rails stack and serves you a page.

The URL looks awesome and can give everyone a unified URL for development that looks great.

So, today I set up my machine to have Pow-like abilities: forwarding myproject.dev to my development server.

Step 1: Edit /etc/hosts

Edit /etc/hosts and add this line:

127.0.0.1   myproject.dev

Note that there’s a tab between 127.0.0.1 and myproject.dev

Step 2: Turn off any web server you’re running on your machine

We want to use Port 80, so nothing else can.

Step 3: Forward port 80 to port 3000 on remote machine

The /etc/hosts entry lets us go to myproject.dev and be taken to our local machine. We want to go to port 80 on our local machine and magically be taken to port 3000 on the remote machine. This is easy with some SSH magic!

Here is the SSH command to make that magic happen:

sudo ssh -F ~/.ssh/config -l vagrant my_remote_host.com  -L 80:my_remote_host.com:3000

The sudo is here because port 80 is a privileged port and we need root access to forward it.

Everything all together

Here’s how everything works:

When you visit myproject.dev in the browser it will make a request for port 80 on your local machine. SSH will see that connection and forward it to port 3000 the remote machine

Conclusion

There are some massive annoyances using this approach, which could be solved by making the remote development machine responsible for translating port 80 into port 3000. I might look into this: having two SSH connections open (one opened for my normal work and one opened via `sudo ssh) is annoying. I’ll post an update here when I find a better solution to this problem.

Even if you want to swap out Step 3 with some other step, you still need to do steps 1 and 2.

Sorry for blowing away history...

Thu, 09 Aug 2012 12:17:52 -0400

Today I decided to tag my blog posts, so I could find them later.

Unfortunately that had an side affect: all the posts look like they were posted today.

But they weren’t.

Posts from today onward will be tagged so I can find them, so this shouldn’t happen again.

Creating a new Python Package (and putting it up on PyPi)

Thu, 09 Aug 2012 12:14:47 -0400

Creating a new Python package

OMG this is easy, why haven’t I done this before?

NOTE: you can ignore github-tools — really that is meant to only help the gh_pages documentation generating.

And, in fact, we have some pretty awesome tools without it!!!

$ paster create -t basic_package PACKAGE_NAME

* hack hack hack*

* hack hack hack *

Test install it somewhere with: $ pip -e hg+/path/to/package#egg=PACKAGE_NAME

* does the package work now? Yes? Awesome *

back in your development directory…

$ python setup.py register

# ^^^^ this will automatically upload package to PyPi

$ python setup.py sdist upload

Creating a new Ruby Package (and putting it up on Rubygems) with newgem

Thu, 09 Aug 2012 12:14:42 -0400

So, in the sprit of the previous article on this blog, I’m going to document how to make a Ruby package and put it up on RubyGems.

Create your project. You can use Jeweler for this, or newgem. I like newgem, because I’m familiar with it. The instructions in this article assume newgem infrastructure
* hack hack hack*
* hack hack hack *
$ rake check_manifest. Your manifest declares what files are in your package. If you have confidence there is no cruft, you could generate this via $ rake manifest I think will generate this for you.
Test your gem. With newgem try rake install_gem.
It’s possible (if you’re using RVM) that this isn’t going to work, and if so just redo the sudo command that failed, but without sudo. Then try to use the gem somewhere (shove it into a test Rails app, for example).

* does the package work now? Yes? Awesome *
back in your development directory…

$ gem install gemcutter
$ rake release_sanity VERSION=1.0.0 (or whatever version number you expect… knowing that the computer might have other ideas)
$ rake release_to_gemcutter VERSION=1.0.0 (or whatever version you want to push

And we’re done.

Lessons learned over the last 72 hours

Thu, 09 Aug 2012 12:14:38 -0400

My current project is crunching hard towards a release. This weekend was release weekend. I learned the following things:

It’s important to know when you’ve hit 0 productivity. Sign of this: looking at your Skype windows, then switch Spaces to GitHub, then switch spaces back to your Skype windows, then switch Spaces back to Github…. and repeat. Congrats - you’ve reached 0 productivity. I hope you’ve noticed this before you spent too much time literally doing nothing.

If you’ve hit this point more than once, and tried to fix it with breaks, coffee, pairing and magic, but you still find yourself here… it’s time to go home
After 17 hours in an office chair, half remembered ygoa techniques help… and give about another 1-2 hours of energy
When your own personal perception of reality gets… “interesting”…, it’s time to go home
Notice when you’re about to literally fall down
The worse thing in the world is saying “I’m about to drop”, and a manager saying “Before you go, can you do these three things that would take 30 minutes to an hour?”… at 4 am.
People who have hit the wall are slightly crankier than they normally should be. I’m sorry.

Churn

Thu, 09 Aug 2012 12:14:33 -0400

I believe I have stumbled upon the very definition of churn:

The Story

For a certain project of mine, I originally implemented the system to support many “legal letters per case”.

Fast forward a month later, where we are told by business to only support one letter per case. After questioning them explicitly and incessantly about “are you sure you’ll only ever send one letter per case?!”, and getting the answer “We’ll only ever ever send one”. We did the work to make the system less flexible and support only one letter per case.

Fast forward another month later, where we are told by business that we want to keep track of multiple letters per case.

The lesson: Specify Behavior, not Implementation to programmers

And this is exactly what happens when your clients specify implementation instead of behavior: you have programmers/consultants make and remake expensive changes. If you had specified behavior, your consultant might have understood the scenario (as I did here), made the correct choice and avoided expensive churn.

Expectational Debt

Thu, 09 Aug 2012 12:14:19 -0400

I was listening to 5by5’s Back to Work’s latest “Expectational Debt” episode. One great way to get a lot of expectational debt? Work 60 hour weeks for 8-10 weeks straight.

And this expectational debt, in my case, involves stupid stuff that I’d be able to do with a normal 40 hour week. Like “hang out with my wife more”, or “answer personal email better”. It’s not expectational debt like “start and finish this project I told people I was going to do”.

I’m used to intense schedules - one of the reasons why I went to RIT was because of their 10 week quarter system. (My thought? “WTF are you going to do in 15 weeks?”) But I feel the expectational debt creep back into my life

Since January, my normal schedule: up at 9:00 check email etc, start work at 9:30. Work until noonish, an hour (sometimes) for lunch. Work until 5:30 or 6. Back at 8:00 or 8:30, work until midnight, 12:30, or 1:00 AM.. essentially until I collapse…. and all this work is for the same project.

Which is insanity that we’re expected to work this hard. This isn’t motivation, it’s slave-driving.

Let me reiterate that point: it’s all for the same project. When I make myself busy with too many side projects at the same time, that’s my fault, my own bad management. When it’s on project taking up all that time, it’s bad project management.

How do you know if you have a good programmer?

Thu, 09 Aug 2012 12:14:13 -0400

So there’s this question is management: “How do I know if this coder I have is any good?”. The answer is simple:

Perform a 360 degree review. Get opinions on this guy from other developers, manager the programmer works with, etc etc.
Now that you have that baseline of information, and have many opinions from technical peers / team members, sit down with the coder and watch him work. You could be detached, or you could actively pair with him on a part of the system you know something about.
Now ask yourself the following questions:
- How often does the coder google something, find a code snippet, and paste it directly into your codebase?
  
  Hint: this should not happen very often, with a good programmer
- Do they write tests, or at the least documentation about his code?
  
  Hint: he should be doing both. Having said that, some parts are just hard to test, or involve legacy code (also hard to test). Bonus: ideally these tests should describe the business behavior of the system.
- Does he make this look easy or does he make it look super complicated (“change this thing here, that thing over there, oh and gotta make sure I switch this thing”). Unless it’s a refactoring, ideally it should look easy.
  
  Hint: Having to change many things to get one smaller ticket done might be a symptom of your codebase, not that this guy sucks. The 360 degree review may reveal this to you.
- How much care / attention to detail do they have? How much care do they exhibit?
- How often do they ask for help to the rest of the team?
  
  Hint: this is tricky, because “asking a lot” could mean you have someone who’s not pulling their weight… or someone who asks questions because they know someone else on the team has the answer. That’s why the 360 degree review before this is important
- Do they have time/space to concentrate, or does someone come by every 5 minutes to interrupt the programmer?
  
  Hint: High amounts of concentration are important for programming. The more they get interrupted, the less work they can do
- If you ask a question of the programmer, does he answer “it’s much too complicated”, or does he go off and explain this highly technical thing for 5 minutes?
  Hint: You want the latter. And yes, those tears in your eyes after 5 minutes? Those are tears of boredom
Notice things about the environment. How many hours per week / days per week is this person working?

Hint: long hours and long days = your highly paid programmer taking longer to do things (and making more mistakes) then normal.

Super hint: you want efficiency in your organization (especially for people who may be getting paid by the hour)
Are you giving your entire team the time they need to do a quality job? Or is it one “can’t miss it” deadline after another? This is demoralizing, and could actually lead to your programmers getting worse
Does the programmer take time during “work time” to take care of personal matters?
Hint: maybe this is not because “he sucks”, but maybe that he’s been worked too hard for too long, and personal stuff can’t be pushed off any more. Again, see the answer for #3. Or maybe “work time” is unreasonable (conference calls at 9:00 PM on a Sunday night, for example) and not allowing time they need to get personal stuff done.