Hm.. true that. The documentation assumes that the reader is familiar with macros and other little quirks of Lisp. There probably should be a section somewhere that goes more deeply into macros, how they work and what they can be used for. I don't know enough yet in order to write that, but I'll keep working on learning Hy.