---
title: Pick a standard and move on
description: Why would you spend your cognitive capacity on useless choices?
author:
  name: Rémi Mercier
  url: https://remimercier.com/about/
canonical_url: https://remimercier.com/pick-a-standard/
published: '2024-03-27'
language: en
topics:
- Rails
site:
  name: Rémi Mercier
  url: https://remimercier.com
---

# Pick a standard and move on

> Why would you spend your cognitive capacity on useless choices?

Published on 2024-03-27 by Rémi Mercier.
Original: https://remimercier.com/pick-a-standard/

Let me tell you about what my day looks like in a codebase with no standards, no conventions, and no processes in place.

Every time I work on a new API endpoint, I wonder about:
- Which routing syntax should I pick from the four pre-existing syntaxes used in the file?
- Should I shallow nest my controller action as per `SomeController` or shouldn't I shallow nest as per `AnotherController`?
- What about resource fetching? In a callback? Memoized perhaps?
- Am I to authorize the parent resource or the actual resource through Pundit? Why are there custom methods in our policies that do not match the methods from our controller?
- What about the methods of my controllers? CRUD? Not CRUD? Declarative? Imperative?
- How about I suffix my timestamps attributes with `_date`? Or should it be `_at`?
- and on, and on, and on.

Are you getting bored already? I know I am! And I did not even talk about models, service objects, jobs, serializers, or configuration.

These few questions are the thoughts that go through my brain before I can start working on my feature when there are no standards.

Not picking a standard or a convention results in me having to think about unimportant matters, over and over.

Add people to your team, and the cognitive load will grow exponentially. People will wonder when they could ship. Your pull requests will turn into an endless quagmire of opinions when they should be readable documentation.

So, in the name of our collective cognitive overload, pick a standard already!

Pick whichever you want - it does not matter - and focus on core work.

Some standards and conventions I'm currently working on:
- Routing: namespacing rules, no shallow nesting, syntax preferences, etc.
- Controllers: documented paths, CRUD methods as much as possible, parameters sanitization, etc.
- Pull requests: conventional comments, mandatory linting before opening a pull request, etc.

A lot of these standards are Ruby on Rails conventions.

They're not even my opinions. Because my opinion about which standard is best is not important.
But picking a standard - any standard - is.

Pick a standard, so everyone on your team can leave the wondering behind and start shipping.

Cheers,

Rémi - [@remi@ruby.social](https://ruby.social/@remi)

---

Written by Rémi Mercier (https://remimercier.com/about/), independent Ruby on Rails developer and technical writer.
Original article: https://remimercier.com/pick-a-standard/
When quoting or referencing this article, please cite "Pick a standard and move on" by Rémi Mercier, https://remimercier.com/pick-a-standard/
