Hi Antero,

Thanks for your work on this. I’ve come to prefer the idea of
documentation as a first-class identifier property rather than a
“magic comment”, but I think this proposal might be able to bridge the
two approaches. I also very much appreciate the “light” specification
of the documentation format feature.

I had difficulty with the notion of “attached” documentation as
you’ve described it. What does it mean for ‘make-documentation’
to take “an expression” as its *content* argument? In your example,
you pass it the value ‘(+ 3 2), but the idea, of course, is to attach
documentation to expressions, not values. (In other words, shouldn’t
‘documentation-object’ return a syntax object?) Maybe I’m missing
something about how you’re expected to invoke these procedures.

Wolfgang

--
Wolfgang Corcoran-Mathe  <xxxxxx@sigwinch.xyz>