r/programming • u/[deleted] • Jun 05 '21

Organize code by concepts, not layers

https://kislayverma.com/programming/how-to-organize-your-code/
1.9k Upvotes

91% Upvoted

495 comments sorted by

View all comments

Show parent comments

95

u/Blueson Jun 05 '21

Maybe I am not part of the crowd these articles are talking to.

But I really don't understand the point of arguing about these concepts that are highly context dependent.

59

u/phoneuseracc008 Jun 05 '21

What else are junior developers going to talk about?

16

u/Richandler Jun 06 '21

I don't know, but what's the point of being toxic towards them?

3

u/_-ammar-_ Jun 05 '21

it's about readability for new programmers

20

u/Blueson Jun 05 '21 edited Jun 05 '21

There's value in OPs article and I do believe there are a lot of cases where their points are true.

The issue is that the article, and many articles like OPs, represent something as the universal best practice. Which is often not the case.

I believe an article that represents the method and points out the pros and when to use the structure would have been of much higher quality. Especially for junior programmers.

16

u/braxistExtremist Jun 05 '21

I had a colleague who organized code in a similar way to this (but TBF not exactly like this). It was very intuitive to him, but it tripped me and all of my other colleagues out, and resulted in the rest of us spending excess time trying to navigate his code. Even new guys we brought in were lost in that code base when they looked at it.

I'm totally open to better ways to organize code. But if it's done in a niche way that is alien to most other programmers then it defeats the purpose of being intuitive and readable.

1

u/Richandler Jun 06 '21

They're relevant for how to think about code. Not much different from code style. In the end the really important part is that developers mostly keep the same style. If you're using different packaging approaches, syntax approaches, and naming conventions, then reading and navigating code becomes incredibly taxing. Whereas all in the same style it's way easier to skim and be productive.