Public

#programming
The Myth of Self-Documenting Code
The Myth of Self-Documenting Code

I tend to think that folk who spout the "my code speaks for itself, I don't need to document it or comment it" nonsense are at best mistaken, and at worst toxic individuals who want to gatekeep the industry.

This is an interesting blog post that contains some thinking I can mostly vibe with.

·buttondown.com·
The Myth of Self-Documenting Code
Codingfont
Codingfont

I've been after something like this for ages. While I've generally always had my goto font for the terminal and editor, I've never really gone out of my way to decide which font really works for me.

This site does a great job of making it a "scientific" test, kinda.

·codingfont.com·
Codingfont
OSA JavaScript recipes
OSA JavaScript recipes
For a while, you've been able to script Mac OS using JavaScript using JavaScript for Open Scripting Architecture (JSOSA). This is a huge improvement on AppleScript. Why? JavaScript isn't a great language, but it broadly follows the conventions that programming languages of the C/ALGOL family have followed for decades. AppleScript is a horrendous mess that should never have come into being.
·gist.github.com·
OSA JavaScript recipes
Code review antipatterns
Code review antipatterns

While most of the article is written as a joke, I've seen some of these "dark side" approaches for code reviews done by actual people who don't seem to want to use code review to lift everyone.

Saving this so I can relive the trauma.

·chiark.greenend.org.uk·
Code review antipatterns