[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:

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

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 mfl...@cs.utah.edu 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