Hacker News new | past | comments | ask | show | jobs | submit login

> I have no idea how those projects fit together because the actual logic is spread out.

There are two kind of mazes:

- those that are so tangled up that you can't make out any kind of structure.

- those that are so regular that you can't make out any kind of structure.




Exactly!

Not because it is split it means that was well split.

If you can reason where something should be, it may be badly organized.

Even single file projects can be organized.

If is small enough and makes sense, why not?

But even in a small file, how is it organized? Utility functions maybe at bottom so you keep business logic together and visible? Maybe some other logic to make it cleaner? The way functions are named follow some convention? What about variables?

I once read one opinion that software developers had more in common to artists and writers than engineers. Writing code is like an art of expressing yourself well to your peers in a way that a computer will also execute what you meant, not the opposite.

The computer can understand whatever entangled mess you write, other people (which may include your future self) may not.


A word cloud could be a useful navigation technique if the words were clickable and the sizes of words could be customized.

They could also link to other word clouds

Generated and updated automatically




Join us for AI Startup School this June 16-17 in San Francisco!

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: