[racket-dev] Release Announcement for v5.1.2

From: Sam Tobin-Hochstadt (samth at ccs.neu.edu)
Date: Mon Aug 1 15:03:21 EDT 2011

On Mon, Aug 1, 2011 at 2:50 PM, Eli Barzilay <eli at barzilay.org> wrote:
> `with-type'
> sounds too specific to be broadly applicable.

`with-type' allows embedding typed regions inside arbitrary other
blocks of untyped code -- it's certainly generally applicable.

> (And BTW, there *is* limited space for release notes -- otherwise these discussions would never happen.)

There's certainly limited space for the most prominent elements of the
release notes.  But I think the right solution there is to pick some
small number of items (say, 5) that are most significant, and
highlight them.  Then much more can be included below that, and
finally some information about minor changes (fixed bugs, for
example).  The git release notes are an example of this style:
http://kernel.org/pub/software/scm/git/docs/RelNotes-1.7.0.txt
-- 
sam th
samth at ccs.neu.edu


Posted on the dev mailing list.