I have a blog! Usually, it’s photos from traveling or “how I made this” or “how I do this” kinds of posts. Basically, if I get tired of people asking me about something, I turn it into a blog post 😂

https://bpev.me/

Probably the most interesting thing from it is the long-ass series of posts describing how I made my music album:

https://bpev.me/notes/vx1-session-the-problem

Is their app big? fwiw on desktop, I just use their config with wireguard app, and that works quite well for me.

deleted by creator

Mmmm kind of? I wouldn’t categorize most comments as describing “extremely weird” reasons, though. Code will generally explain the “how”, while comments can describe the “why”. For example, think of an enum with ViewSize “mini” and “full”. It might be nice to have a comment to briefly summarize what ViewSize is meant to represent, and maybe link to a spec. Basically, a comment here will connect the intention with the implementation.

A more inline-comment example of this might be if there’s a slightly nuanced case that you want to be very clear about, ala maybe a Javascript true/false/null case, where you might be checking === false, and specifically don’t want someone to refactor it into a falsy check. Kind of contrived example , but that sort of thing. This is probably more the “extremely weird” comment you’re talking about; almost just a warning that this might not be what you think it is.

The other common use-case I find good for comments is for summarizing the goals/purpose of a complex function. This is mostly for future people who might utilize this function, and don’t want to read through a bunch of code, just to remember the nuances of what it’s supposed to do. For example, a “sortEvents” function, you may want to summarize the business requirements of the sort at the top. Although, this kind of thing may be different depending on how documentation is stored.

My only thing I know about Salon is that at one point, they had a piece about how depressing it was to live in a hacker house, and I was like “wait. I lived in this exact apartment”. I remembered the Pinterest guy who lived in the closet. That was slightly surreal.