DEV Community

Discussion on: What long-held belief have you eventually changed your mind about after learning from experience?

practicingdev profile image
Practicing Developer Author • Edited on

Really good point about the need to establish context before you can even make sense of the risks and rewards that come along with a "best practice."

In recent years I've become a big fan of teams keeping their own running notes around any particular working practices they have.

The template I use varies depending on who I'm working with and what I'm working on, but it usually looks something like this:

  1. Here's how we do ThingX.
  2. Here's why we do it that way.
  3. Here are the alternatives we know about and why they don't quite work for us.
  4. Here are some reference materials that helped us make this decision.
  5. Here are things we've learned (both good and bad) while doing things this particular way.

I find that once you strip away that appeal to external authority, it becomes a much more thoughtful and useful way to coordinate on how things get done, and also makes it clear that you are free to change your mind if you learn something new -- something that rarely happens when people take the idea of "best practices" literally.

cassandraspruit profile image
Cassandra Spruit

Those are excellent things to keep track of! Love points 3 and 4, especially.

It would save so much time and effort if someone simply said "we already looked into that and here's why we didn't go that route".