Hacker News new | ask | show | jobs
by aquova 1 day ago
While I do agree, if the author is reading the comments one piece of feedback I have is the overuse of the phrase "In this article I will...". It's a bit of a pet peeve of mine, and they use a version of the phrase three times in the first four paragraphs.
3 comments

I find the convention whereby authors 'explicitly tell readers what they're going to do' a hallmark of good explanatory writing, so long as the writing is supposed to be explanatory and the author follows through.

So your comment got me to take a closer look, and yeah, the author could certainly cut "in this article" and "in this blog post" from the third and fourth paragraphs.

Otherwise, yeah, this is an excellent piece of work. Reminds of that ancient, short, black and white film from General Motors that artfully demonstrates how differentials work.

If the HN commentariat knows of similarly excellent educational work that uses intuitive visual to explain software concepts, please do share.

If the HN commentariat knows of similarly excellent educational work that uses intuitive visual to explain software concepts, please do share.

I have not gone through it yet, but this explanation of how transformers work is in the same class as Ciechanowski's work IMO: https://poloclub.github.io/transformer-explainer/

For JPEG compression: https://parametric.press/issue-01/unraveling-the-jpeg/#param... (anchor doesn't work for me, but it's the one with the caption "Move slider to adjust the amount of subsampling applied." which made me understand the motivation behind using chroma)

For polygon sum/union/difference: https://sean.fun/a/polygon-clipping-pt1/ (the diagram captioned "Combined Fill Annotations" at https://sean.fun/a/polygon-clipping-pt2/#annotating-segments is my favourite visual proof)

For cryptanalysis: https://random.tastemaker.design

For Fourier transforms: https://brianmcfee.net/dstbook-site/content/ch05-fourier/Sim...

For digital typesetting of Arabic: https://lr0.org/blog/p/arabic/

I learned this as "Tell them what you're going to tell them, tell them, then tell them what you told them."
After looking at this enormous labor of love, is this really what you chose to comment about?
I'd rather read imperfect human writing than modern day AI slop. Seeing human writing "mistakes" like this is a breath of fresh air.