Similarly I often read ticket or PR descriptions written by Claude that are so jargon-heavy that I just can't understand on first try. On one side it's a reality check because I always considered English to be close to a mother tongue for me, on the other side I never had to deal with words like "idempotent"... (Seriously, when did this become one of the go-to words to use?)
Idempotency is a crucial trait in the world of web APIs (and any other system where commands that modify state might need to be retried due to communication failures). It's not a new word or concept, but it's certainly a niche one.
Yes. It’s even worse than jargon tho I think it just invents its own metaphors. At first I thought this was clever and useful, helping me to internalize the code (“the normal path vs the escape hatch”) but I’m increasingly finding the metaphors to be so thick and esoteric that it’s actually a hurdle to understanding the actual code.
