All entries
#communication#team#writing

Bullet Points vs Numbered Points: Clearer Team Communication

A small writing habit that quietly improves how engineering teams discuss things in Slack — use numbers, not bullets.

As a software engineer, I spend hours every week discussing things on Slack — design systems, code reviews, deploy timing. Remote work made messaging the default channel.

One tiny habit kept slowing those discussions down: how we write lists when sharing updates or tasks.

The bullet-point problem

You've probably seen this:

  • Fix the login button
  • Fix the configuration data user
  • Fix the caching issue on the Redis setup

Looks fine. Until someone replies:

"Hey, that Fix configuration data still has a bug." "The second point seems to be missing the acceptance criteria." "Hmm… number 3 looks like it's not actually a Redis issue."

Now you're counting bullets to figure out which item they meant. With 10 items the cost adds up — minutes wasted clarifying before fixing anything.

The fix: use numbers

Same list, numbered:

  1. Fix the login button
  2. Fix the configuration data user
  3. Fix the caching issue on the Redis setup

Now the reply is:

"2. The acceptance criteria seem incomplete." "3. I think the issue is on the Redis server, not the setup."

Instantly clear. No counting, no guessing. Months later when you scroll back through old threads, you'll thank yourself — numbered discussions are way easier to track.

Small change, big impact

Since switching to numbered lists I've noticed:

  1. Discussions stay organized
  2. People reply faster (they know exactly what you're referring to)
  3. Past messages are easier to reference when debugging or reviewing history

Not just a tech-team trick. Works for any team — design, marketing, product, ops.

Communication isn't only about what you say. It's about how easy it is for others to understand and respond. One of those small lessons I learned the hard way.


Originally published on menulis.id.