Hi HN, I write code and unit tests for other departments in my company. For me, writing code in a programming language feels natural, so I like to use the notation of the language itself. A colleague likes to write code more like prose so someone from another (non-IT) department should be able to read it. How do you deal with this in your company?
I think I read an article about this a few days ago, but I can't seem to find it anymore. Does someone still remember this?
I’ve worked with “code like prose” people and found them pretty difficult to work with. I’ve also found most of them to be not that great technically or they have exclusively Ruby on Rails backgrounds and can’t seem to function on any other technology or approach.<p>I don’t think the sales guy needs to be able to read channel handling logic or care about how the react code is organized.<p>Engineers should write good code that can be easily understood and modified by other engineers. Are engineers going to cold call people or run the financials? No their job is to build systems and keep them running.
I’ve always tried to use naming of variables and methods to make it obvious what the code is doing. Something like:<p>```
if service_is_disabled:
start_service()
else:
send_notification(“Service is running”)
```
What does “code like prose” look like? I had a group project in college with a guy who used MS Word to write code in paragraphs..formatted like an English paper (I’m not kidding); is this what you mean?<p>(Looking back I often wonder how long this guy wrote code like this before someone said “knock it off”..)
I think it's important to keep a consistent style in a repository. Ideally, the style should be kept _among_ repositories too, but given that different people like different thing, allowing them to explore the pros and cons might be a better strategy to achieve it.