Comment by johnisgood

7 months ago

This is why I have DEVELOPER.md. It explains why I chose X over Y, among many other things. Someone wrote a nice list: https://news.ycombinator.com/item?id=44581069.

That's a nice idea, but the problem more comes from using a language designed to help you get ideas from your head into production using the fewest possible characters results in extremely terse code.

You can say all sorts of things around "write better documentation" and so on, but step 1 really is "don't use a code golfing language"

  • I do not disagree. In DEVELOPER.md you are not supposed to have an intro to the language you picked.