Hacker News Reader

I honestly wish more people would try to organize their files to be read top-to-bottom, it makes it much faster to grok something new.

But of course there are lots of other factors constraining the way a file can/should be ordered, depending on language

Yes, the "inverted pyramid" concept from journalism. Most important details up top, implementation details down below.

In our (Swift) codebase, this typically translates into "publicly-consumable interface up top, private and internal functions down below".