So, why does it happen? Why are we always wading?

There are many factors that contribute to it. Let’s picture a company growing, hiring more employees to grow faster, new developers come in, old developers leave, the dynamic business changes the requirements quite constantly, the communication between IT and business has gaps, developers are so focused to achieve the sprint commitment, the rush is always putting pressure on everyone working on the project, no one cares to learn about the user-product relationship, no one cares to write tests, developers cannot design as it seems not to deliver short term value, TDD is philosophical, the company doesn’t invest time to train its teams, the most valuable practice is what solves the today’s problem, hero culture rises, we always need more logs to try to realise what is going on, we need to lead the market…

— Felipe Martinsm, "Clean Code, bullshit or common sense?"

Read More ⇨

I briefly covered a mapping function in "The Functional Shape of Loops" which can be used for one-to-one mapping, meaning that one item in the input collection produces one value in the output collection:

[1, 2, 3] |> map(n => n * 2) // [2, 4, 6]

Sometimes it's useful to have a one-to-many mapping, where one input produces multiple output values.

Read More ⇨

I was writing some code in a template that looked a lot like:

if (collection.HasItems)
{
  foreach (var item in collection)
  {
    <some markup>
  }
}
else
{
  <some message about no items>
}

and I realized that it would be awfully nice for for, foreach, and while loops to have an else clause.

Read More ⇨

Learning to program, it's quite common to come across many resources and code samples that include imperative loops of various sorts (particularly for and while).

Frequently when I see examples that include loops, I cringe. They often include many steps that make them harder to understand because there is so much happening every iteration.

Instead, I much prefer to use a functional approach to iteration. Each step can be converted to an individual function and those functions can be applied to the entire collection to produce a result.

There are several advantages to the functional approach over imperative:

• Named functions are essentially declarative; they describe what will happen rather than how it will happen.
• Splitting functionality into individual functions allows for code reuse.
• Pure functions can easily be tested individually.

Read More ⇨

This is a follow-up to my "Multisort via Composition" post, and won't make sense if you haven't read that post.

When sorting on a single dimension, changing the sort direction can usually be handled by changing the sorter function directly.

const data = [33, 1, 95, 77, 54, 91, 38, 89, 48, 24]

// ascending
data.sort((a, b) => a - b)

// descending
data.sort((a, b) => b - a)

making this act dynamically based on some external input can be reasonably handled by updating the function as well:

const ascending = getAscending() // true or false
data.sort((a, b) =>
    ascending
        ? a - b
        : b - a
)

This works fine for a single sorter, but quickly becomes untenable once multiple sorting dimensions are used:

Read More ⇨

Sorting a collection of data in a single dimension is pretty straightforward in most programming languages. It's quite common to use some sort of comparison interface that exposes a function with two parameters of the type being sorted, and expected return values of -1, 0, or 1.

For example, JavaScript has Array.prototype.sort, C# has IComparer, and PHP has usort.

This works quite well when you want to sort on a single property:

Read More ⇨

I recently saw Amber Weinberg's tweet after it blew up on twitter:

I refuse to use Sass
I refuse to use React
I refuse to use Redux

I’m still here and still have plenty of clients who appreciate clear, clean code.

— Amber Weinberg (@amberweinberg) December 1, 2017

My gut reaction was that it was a bit harsh to those of us who choose to use Sass, React, or Redux. It implies that anyone who uses those tools isn't writing clear, or clean code, which explains why so many front-end developers collectively flipped thier shit at it.

But seeing as Amber's a WordPress developer, it entirely makes sense to me that she would have no use for React and Redux. I can even see why she'd avoid Sass too*. The types of problems best solved by a WordPress site do not necessitate any use of React or Redux.

Read More ⇨

Joel Spolsky recently tweeted a message about some phrasing in a question that was a strong indicator that the question was inappropriate for Stack Overflow.

buddy if your stackoverflow question includes the words "I want to make some kind of programming" you might be asking on the wrong site

— Joel Spolsky (@spolsky) November 28, 2017

to my surprise, this elicited some strong reactions from other developers chastising him for turning away beginners from the site.

Here's the thing about Stack Overflow:

Read More ⇨

When writing release notes or changelog entries it's important to keep some things in mind. First and foremost it is important to be aware of who the release notes are for.

Release notes are not for you...now.

Release notes are for future you.

Release notes are for a user who wants to know what the latest updates are.

Release notes are for a stressed-out colleague who's trying to narrow down when they think a particular breaking change might have occurred.

Identifying the personas of the people who will be reading release notes is important so as to effectively communicate with them. If you don't understand your audience you may end up losing them.

If you write bad release notes for a product, you may frustrate your users into finding an alternative solution that feels more stable, or is more predictable.

If you write bad release notes for a client, you may end up confusing or angering them.

If you write bad release notes for your team, you may end up alienating your maintainers and slow the pace of progress.

Read More ⇨