NHacker Next
  • new
  • past
  • show
  • ask
  • show
  • jobs
  • submit
When code is a maze, smart developers make maps (medium.com)
jorisw 14 minutes ago [-]
Smart developers don’t write mazes.

> In code, comments are our signposts

No. Naming and good architecture are. Intuitive folder trees. Concise docs. Clear separation of concerns such that naming can suffice.

The more comments you need to ‘map’ your code, the worse of a job you’ve done.

tromp 5 minutes ago [-]
When code is a maze describes my 1988 IOCCC entry [1]

    char*M,A,Z,E=40,J[40],T[40];main(C){for(*J=A=scanf(M="%d",&C);
    --            E;             J[              E]             =T
    [E   ]=  E)   printf("._");  for(;(A-=Z=!Z)  ||  (printf("\n|"
    )    ,   A    =              39              ,C             --
    )    ;   Z    ||    printf   (M   ))M[Z]=Z[A-(E   =A[J-Z])&&!C
    &    A   ==             T[                                  A]
    |6<<27<rand()||!C&!Z?J[T[E]=T[A]]=E,J[T[A]=A-Z]=A,"_.":" |"];}
[1] https://tromp.github.io/pearls.html#maze
jarofgreen 40 minutes ago [-]
> Typically keep comments on a single line without line breaks — if a comment is useful, developers will scroll to read them, if it’s not they can easily scroll past it.

Disagree. Personally that sounds like a massive barrier to reading the comment to me. Limited width column text is generally regarded as easier to read, make your comments easier to read. Especially as I probably have the code open in a limited width window, as that's what I expect from code.

someothherguyy 27 minutes ago [-]
What? You don't like horizontally scrolling 6000 columns to read something?

https://en.wikipedia.org/wiki/Code_folding

jarofgreen 16 minutes ago [-]
Yeah, if IDE's allowed code folding of comments then the authors original problem (having to scroll past comments they thought weren't useful) wouldn't be that big a deal.
someothherguyy 13 minutes ago [-]
many do. for example: https://www.jetbrains.com/help/idea/code-folding-settings.ht...

there are also extensions for vscode that do this, vim plugins, etc

dozerly 36 minutes ago [-]
Who doesn’t have soft wrapping enabled in 2026? Line breaks are irrelevant
jarofgreen 18 minutes ago [-]
If line breaks really were irrelevant, the author wouldn't have felt the need to give a tip all around optimising line breaks.

Personally, I would have hoped by 2026 we had better IDE's and tools for managing code in text files such that developers with different preferences for a number of characters in a column or things like how you display comments can be accommodated. Yet still teams end up arguing about what standard to use.

ezrabuenk 22 minutes ago [-]
I, in fact, do not have wrapping enabled in my IDE....
tacomagick 17 minutes ago [-]
You never wrote Java I see
xboxnolifes 8 minutes ago [-]
Java is why I don't have line wrapping enabled. It makes code unreadable when everything needs to be wrapped.
Lindby 28 minutes ago [-]
Soft like breaks in a code editor? That's insane
Cockbrand 23 minutes ago [-]
And so the war began.

This is a bit like vim vs Emacs - everyone should be able to use their favorite setup, and the formatting should not get in the way of the engineer's preferences.

verdverm 31 minutes ago [-]
Who makes assumptions about how others do things in 2026? Line breaks are apparently relevant, review agents complain about them, soft breaks are super annoying for vim motion users, opinions are still like ani
22 hours ago [-]
Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact
Rendered at 06:54:10 GMT+0000 (Coordinated Universal Time) with Vercel.