News for hackers. Stuff that matters.
Re:Software component names should be whimsical and cryptic by xupybd on Tuesday September 13, 2022 @06:06AM (#32822375)
This is terrible advice. Cryptic names are horrible. It's a layer of cognitive overhead that no one needs. Yes if it gets so big that it's out grown it's original purpose that's a problem. But if it's really big people know what it is because it's big. If it's not that big rename it!
Re:Software component names should be whimsical and cryptic by MrSqueezles on Tuesday September 13, 2022 @06:33AM (#32822537)
Yes. The advice is contextual. If you're making a public web framework, probably don't call it Web Framework. If you work at a company and you're writing the one and only hotel booking service, do call it Hotels instead of forcing your coworkers to memorize yet another cute name.
Re:Software component names should be whimsical and cryptic by pavlov on Tuesday September 13, 2022 @07:02AM (#32822725)
This only works once though.

In ten years, none of the original developers of Hotels are with the company. The new generation of engineers is upset both with Hotels’ limitations and the fact that it’s not written in XYZ language which they really want to have on their résumés.

So they embark on a total rewrite of Hotels, and to emphasize the awesomeness, most likely it will be called either Phoenix (because one out of three internal 2.0 rewrite projects is called that) or Venice (because it’s a place that has lots of hotels).

As part of their ambitious rewrite, they also start building a custom message queue in XYZ. It’s called Milan so there’s now a cute city theme. A bunch of other exciting NIH XYZ greenfield projects spring up, all with city code names.

Another ten years go by. A programmer complains to another:

“Where I work is the worst. There’s all these projects written in XYZ which nobody uses any more, and they’re all named after random cities. Why couldn’t they call the hotel booking service something descriptive.”

Re:Software component names should be whimsical and cryptic by TakeBlaster16 on Tuesday September 13, 2022 @10:21AM (#32824633)
I solve that by naming my greenfield projects "hotels_old" from the get-go. It makes things easier for the next guy who replaces it.
Re:Software component names should be whimsical and cryptic by winReInstall on Tuesday September 13, 2022 @09:00AM (#32823677)
Its something that works in the cloud on a server. Its a cloudcomponentprocessor. Thats exactly what it is, what it does and absolutly context free.

Descriptive alone does not cut it.

Bonsupoints if your software throws errors, that throw customers. "I want to book a flight to NY, but it keeps saying Venice:DB is full"

Re:Software component names should be whimsical and cryptic by npteljes on Tuesday September 13, 2022 @08:27AM (#32823406)
They can also name it Hotels2. It's up to the people what they name it, some like cute names, some the descriptive.
Re:Software component names should be whimsical and cryptic by doubled112 on Tuesday September 13, 2022 @07:35AM (#32822978)
I know! Hotels-rs
Re:Software component names should be whimsical and cryptic by _1 on Tuesday September 13, 2022 @08:52AM (#32823611)
My company has been throwing `-ng` on all the new versions.
Re:Software component names should be whimsical and cryptic by unethical_ban on Tuesday September 13, 2022 @09:43AM (#32824190)
Until that's expired. project-ng-ng? (I know the pain, we did the same thing at work).
Re:Software component names should be whimsical and cryptic by mattkrause on Tuesday September 13, 2022 @10:04AM (#32824433)
No, `project-ds9` is the obvious upgrade path.
Re:Software component names should be whimsical and cryptic by doubled112 on Tuesday September 13, 2022 @10:42AM (#32824894)
They included the "the" in placed I've worked. project-tng
Re:Software component names should be whimsical and cryptic by JasonFruit on Tuesday September 13, 2022 @10:48AM (#32824973)
project-picard
Re:Software component names should be whimsical and cryptic by zem on Tuesday September 13, 2022 @12:51PM (#32826851)
enterprise software at its finest
Re:Software component names should be whimsical and cryptic by 0x457 on Tuesday September 13, 2022 @02:30PM (#32828380)
`-ng+`, `-ng++`
Re:Software component names should be whimsical and cryptic by pindab0ter on Tuesday September 13, 2022 @10:02AM (#32824411)
What’s ‘ng’ short for? Next generation?
Re:Software component names should be whimsical and cryptic by jayd16 on Tuesday September 13, 2022 @10:30AM (#32824743)
How about just Hotels 2.X.X.X? Honestly, not much reason it can't be the exact same namespace depending on the language and whether the new and old would be imported by the same project.
Re:Software component names should be whimsical and cryptic by xpe on Tuesday September 13, 2022 @09:00AM (#32823684)
If someone doesn't like something, they may criticize anything about the thing, such as (a) having or a silly name or (b) having a generic descriptive name. Sometimes you just can't win. Sometimes such 'spillover' criticism is better understood as collateral damage from deeper frustrations.
Re:Software component names should be whimsical and cryptic by wzdd on Tuesday September 13, 2022 @08:25AM (#32823389)
I can easily imagine the conversation after everyone has started using Hotels to book meeting rooms as well, so I think this is an argument for the other side. :)
Re:Software component names should be whimsical and cryptic by rgblambda on Tuesday September 13, 2022 @06:45AM (#32822622)
I don't even use Serverless Framework that often yet get irrationality annoyed at how generic a name it has.
Re:Software component names should be whimsical and cryptic by bayindirh on Tuesday September 13, 2022 @06:31AM (#32822523)
I opt to compromise and use middle ground name, which both related and fun.

A tool for sending mails via Mailgun? “Railgun” then, for example.

Re:Software component names should be whimsical and cryptic by bckr on Tuesday September 13, 2022 @06:57AM (#32822692)
This is my stance. 2 words: Memorable Use.

Banana Cache

Hadouken Security Service

Lightfoot Containers

I mean, this is pretty much the AWS formula.

Re:Software component names should be whimsical and cryptic by bayindirh on Tuesday September 13, 2022 @07:45AM (#32823044)
For bigger services, it makes sense. For smaller utilities single word names are better IMHO.

I'll keep this formula in mind too, and use it when I develop something bigger.

Re:Software component names should be whimsical and cryptic by tetha on Tuesday September 13, 2022 @12:45PM (#32826750)
This is the right middle ground imo as well. It adds a bit of simple difference between the 15 different exporters, without being too far off. We have things like the "Tenant Saw" - extracts a tenant from a multi tenant system, or a foosystem-butler called Vlad - automating and scripting a bunch of busywork around the foosystem.
Re:Software component names should be whimsical and cryptic by thiht on Tuesday September 13, 2022 @01:45PM (#32827741)
> Cryptic names are horrible. It's a layer of cognitive overhead that no one needs

I disagree with that. Cryptic names can become jargon, and jargon is useful in expert teams. At my last job we had a service whose role was to convert operations from system A to system B so at first we named it systemAOperationsToSystemBOperations. The name was clear but it was a pain in the ass to talk about it. We renamed it adios as a shorter name (irks like a fake acronym of the initial name) and it became way easier to talk and reason about our system. We lose a few minutes once in a while to remind juniors what adios does but we gain an efficient name to discuss the service day to day.

Re:Software component names should be whimsical and cryptic by jstimpfle on Tuesday September 13, 2022 @07:16AM (#32822824)
It says "component". How many components do you have? I suppose if need to deal with more than a dozen components simultaneously, something is wrong. What is worse, the overhead of maybe not knowing a one-word description of component FancyName once in a while (so you have to look it up, pressing F12 or such), or having to deal with a obsolete, too long name (trying to be clear, or having too disambiguate between multiple redesigns), or unfitting name: all the time you're working with the thing?
Re:Software component names should be whimsical and cryptic by xupybd on Tuesday September 13, 2022 @07:27AM (#32822919)
Screens are huge now. You can fit long names. Auto complete makes typing long names easy. Let your code read like prose. Save the brain for solving the business problems not for understanding the code.
Re:Software component names should be whimsical and cryptic by userbinator on Tuesday September 13, 2022 @09:37AM (#32824103)
Long names are easier to read the first time, and become an impediment thereafter. Especially when you have multiple long names that differ only in a few characters.
Re:Software component names should be whimsical and cryptic by hulitu on Tuesday September 13, 2022 @10:41AM (#32824891)
Not really. Screens are wider. An older 21 inch was taller than a 24 inch tft
Re:Software component names should be whimsical and cryptic by Vinnl on Tuesday September 13, 2022 @08:40AM (#32823500)
The point is that descriptive names tend to either be overly generic (also a cognitive overhead, especially when you have multiple such generic names), or too specific and therefore quickly inaccurate (and even larger cognitive overhead).

Oh, and as for "If it's not that big rename it" - this article is specifically about things that are hard to rename (e.g. public facing APIs or libraries):

> Now, if a name is going to be easily changeable forever, please do make it descriptive.