Only recently did I learn about and start to use `history`:
http://docs.racket-lang.org/scribble/Version_History.html
This could be used as-is with the `#:changed` clause:
@history[#:changed "1.7"]{Deprecated. Instead use @racket[shiny-thing].}
But now that you mention it, a new explicit `#
I know this is at least somewhat orthogonal to the points you’ve made, but
perhaps it would be best to standardize how “warning” messages are rendered in
documentation. For example, the “unstable: may change without warning” messages
are quite useful, but I have no idea how I’d render those in m
There's still a problem of people stumbling upon deprecated stuff in the
Racket manuals, and going to a lot of trouble to use it without
realizing that it's deprecated.
For a very quick fix, how about appending "[DEPRECATED]" to certain
manual titles, as an easy way of marking each page of the
