Re: [racket-dev] Documentation

2013-12-08 Thread Robby Findler
Should the history.txt files get stuck into the end of the manuals for the time being? Robby On Sun, Dec 8, 2013 at 8:37 AM, Matthew Flatt wrote: > At Sun, 8 Dec 2013 11:09:39 +0100, Jens Axel Søgaard wrote: > > In cases where the semantics of constructs are changed, should the > > documentati

Re: [racket-dev] Documentation

2013-12-08 Thread Matthew Flatt
At Sun, 8 Dec 2013 11:09:39 +0100, Jens Axel Søgaard wrote: > In cases where the semantics of constructs are changed, should the > documentation have a margin note stating the version number of the > change? Yes, it really should. Details like this get listed in "HISTORY.txt" (the `case` form app

[racket-dev] Documentation

2013-12-08 Thread Jens Axel Søgaard
In cases where the semantics of constructs are changed, should the documentation have a margin note stating the version number of the change? I am in particular thinking of "case": http://docs.racket-lang.org/reference/case.html#%28form._%28%28lib._racket%2Fprivate%2Fmore-scheme..rkt%29._case%29%