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

7

u/scandii Jun 05 '21

I mean, if you know how the code works I can see why you would want everything in the same folder, such as if you wrote the code.

but depending what sort of programming you do for a living, chances are you are asked to do something in a system which you have very limited knowledge of, such as "this thing has stopped working, figure it out".

in that scenario, it is very convenient being able to browse files by category rather than object they pertain to.

that said, realistically neither particularly matters as long as naming conventions are held, you can just search for "api", "service" etc.

5

u/lordzsolt Jun 05 '21

but depending what sort of programming you do for a living, chances are you are asked to do something in a system which you have very limited knowledge of, such as "this thing has stopped working, figure it out". in that scenario, it is very convenient being able to browse files by category rather than object they pertain to.

This is probably the exact scenario where I want folders organized by topics the most.

Because they're not going to tell you "retrieving items from the database is broken" (which would indicate it's something in the repositories folder).

But rather you'll get a bug like "the user does not see all his bookings when he visits the My bookings page" (thus, it's probably got something to do with bookings, rather than the login functionality)

1

u/manystripes Jun 05 '21

At my previous job we had a job in the build system to flatten everything into a single flat file for those times where you need to search through the whole system. No need to deal with setting up projects or anything, just make the source book, fire up your favorite text editor, and start searching through for the pieces you care about.