Software

6-Step Guide For Software Engineering Decision-Making

by dxiang 2021-06-16

Software engineering decision-making is a stressful and time-consuming process. When the stakes are high, you will be met with opinionated programmers, insurmountable organizational constraints, and unfortunate baggage from old projects. Consensus is difficult.

In a previous post, “Staff Software Engineer Responsibilities“, I mention that the act of “Transforming Competing Opinions Into Decisions” as one of a Staff Engineer’s primary responsibilities. I note that prolonged technical debates are a risk for organizations and that Staff Engineers must “push through friction” in order to arrive at decisions. However, once you feel the friction, it’s never clear how you’re supposed to push through it.

This article presents a generalizable 6-step outline to help engineers drive consensus. This is a set of heuristics, not an algorithm.

Software

What Is A Runtime Environment?

by dxiang 2021-02-26

“Runtime” and “Runtime Environment” are some of the most overloaded terms in software development. It’s confusing for everyone; this word means many different things in many different contexts. This post’s goal is to provide you with an intuition behind the many use-cases of “runtime.”

Management Software

Software Engineering Culture Metrics

by dxiang 2021-02-10

Company culture. Extremely important, impossible to define.

Impossible to define doesn’t mean impossible to understand. A surface-level understanding of culture is available via Glassdoor and company onboarding documents. However, a deep understanding of culture is only available via experience.

This article focuses on a set of values often associated with software engineering culture. Instead of the discussing the values themselves, I discuss the activities which measure them.

Management Software

Staff Software Engineer Responsibilities

by dxiang 2021-01-19

The path of the Staff Software Engineer represents the career progression of a technologist. Senior Engineer leads to Staff Engineer which leads to Principal Engineer which hopefully leads to a comfortable retirement. Unfortunately, Staff Software Engineer responsibilities are often poorly defined by management. The goal of this article is to give clarity to these responsibilities so aspiring Staff Engineers—and their managers—can perform their jobs more effectively.

Software

Kafka As A Database? Yes Or No

by dxiang 2021-01-10

I recently read through a Hacker News thread discussing the article “Kafka Is Not A Database”, by Arjun Narayan and George Fraser. The opinions behind this topic are fascinating and I enjoyed sifting through comments from both sides of the table. For the purposes of this post, I’ve labeled these two broad groups of thoughts as Team Blue and Team Red.

Team Blue believes that Kafka, a popular streaming platform, has the potential to be the source-of-truth for your data—replacing one of the key responsibilities of conventional databases.

Team Red strongly disagrees.

The following is high-level summary of these opinions.

Software

Software Engineer Vs Programmer

by dxiang 2020-12-31

The difference between the titles Software Engineer vs Programmer vs Hacker vs {other_coding_title} is rooted in a person’s ideals. This difference is succinctly summarized in the wonderful article 3 Tribes of Programming, where the author buckets programmers into three distinct “tribes”:

You are a poet and a mathematician. Programming is your poetry
You are a hacker. You make hardware dance to your tune
You are a maker. You build things for people to use
josephg.com

The author asserts that all coders lean towards one of three tribes—The Poet, The Hacker, or The Maker. Even though a stark contrast is made to separate these groups, these tribes are not mutually exclusive—many programmers are Makers by day, Hackers by night, and aspiring Poets by weekend.

Software Engineer vs Programmer is a false dichotomy I’ve created to separate Makers from Non-Makers. I believe this separation to be relevant because the majority of us are Makers by profession—myself included. Without a doubt, the most accessible path to make a career out of code is the path of the Maker, or the Software Engineer.

If the Maker represents the Software Engineer, who is the Programmer? These are the Hackers and the Poets. These are the coders that code for the raw love of computing, the people who rightfully put the science in computer science. You’ll find these “purist” programmings developing new languages, tweaking assembly, and occasionally scoffing at the work of Makers. Pursuing a career as a Programmer will not be as accessible as pursuing a career as a Software Engineer.

Practically speaking however, this kind of separation is not helpful; everyone writes code for their own reasons. Since the majority of us are Makers, let’s dive into what’s actually important for a Maker to focus on.

Management Software

The Debugger’s Mindset

by dxiang 2020-08-18

Debugging is a critical skill. More important than the skill is the mindset. The debugger’s mindset is the attitude that you must always understand the why behind a problem; any ambiguities or unknowns are unacceptable. This mindset has the potential to carry you from debugging small functions to solving difficult organizational issues.

Management Software

The Importance Of Technical Planning

by dxiang 2020-08-10

Creating a technical plan is a sign of professionalism and maturity as a software developer. No matter what you’re working on, whether it be a straightforward feature extension or a massive data migration, a technical plan must be written.

Why Should I Write A Technical Plan?

A written plan forces you to think deeply about your work.
A written plan facilitates communication. Review it, talk about it, reference it.
A written plan serves as documentation. What did we set out to do and how did we do it?
A written plan organizes your execution.
A written plan invites collaboration, which begets technical thoroughness and stakeholder alignment.
A written plan signals professionalism.

As you write your technical plan, here are some ways to ensure the process is as effective as possible.

Software

Complete Code Review Checklist

by dxiang 2020-04-12

Code reviews are an essential part of software development. To be good at the craft, we must be able to review the craftsmanship of others. The more books you read, the better you write; the more code you review, the better you code. The following 12-item code review checklist is a breadth-first traversal; each item is presented at an extremely high-level and deserves more of your attention.

Software

10 Bad Habits For Software Developers

by dxiang 2019-12-05

Any developer, with any level of experience, can have bad habits. This is the junior developer neglecting the ripple effect of his changes. It could just as easily be the senior engineer rampaging through the codebase with her rewrites.

Bad habits are just habits; they do not define a person or their abilities. When your colleague’s code falls below your expectations, it’s unfair to point fingers and blame them for your company’s growing mountain of tech debt. With large-scale software development, success and failure are never attributable to individuals; success and failure are attributable to teams.

Bad habits can be replaced with good habits. Here are my top 10 bad habits for software developers. Watch out for these—we’ve all been guilty.