A common criticism of macro systems is that it's hard to distinguish functions from syntax. Reading BDD foo.feature files feels the same!
Related Posts
I'm pretty impressed with Cursor: I've successfully asked it to perform codebase transforms in English, and it's worked!
E.g. "Replace all calls foo(..., true) with foo_immediate(...) define a foo_immediate function".
I'm still reading the diff and checking tests -- it's still AI after all.
Go has an elegant approach to defining example functions, which are shown in docs as `main()` with the output: https://go.dev/blog/examples
One cute feature of markdown I'd not noticed before: there's no syntax for images *without* a description (i.e. alt text).

https://spec.commonmark.org/0.31.2/#images