The release announcement sketch that I have so far is below. Please
mail me new items and/or edits.
Please phrase announcements using complete sentences and avoid the
word "now".
As of this release:
The raco setup command can generate markdown documentation, using the --doc-markdown option.
A number of changes address the teaching "#lang" teaching languages, the ones chosen by the use of a "#lang" first line in conjunction with the "The Racket Language" selection in the Language dialog:
These languages can specify DrRacket annotation values, to enable test coverage by default.
These languages display coverage information by default in DrRacket.
These languages display source-code locations in the same way as the menu-based *SL languages.
DrRacket's background expansion disables errortrace annotations, for faster syntax checking.
The raco pkg install command includes new options that provide more install-time configuration flexibility: --adjacent-deps, --destdir, and --attach, and a refined --skip-installed.
The ffi/unsafe/runtime-lib library provides a define-runtime-lib mechanism similar to define-runtime-path, allowing location of libraries located relative to a source file.
The prompt-tag/c contract generator no longer performs checking on call/cc when the #:call/cc option is not present.
The impersonate-prompt-tag function takes an additional argument that allows checking and update of results for composable continuations.
The error-syntax->srcloc-handler parameter provides control over the mapping from syntactic forms to source locations for error handling.
Uses of (tcp-listen 0) will retry when it fails with "address in use".
The racket/base module requires fewer internal modules and instantiations.
The file/zip package provides a new mechanism for greatly increased control over zip file generation, allowing in-memory file sources and per-file compression control.
I am sorry but as someone who is producer and client here, I don’t get what these bullets are trying to convey.
Also, the current cmd-R menu does not include options to select #lang htdp/bsl or #lang schreibedeinprogram/isl
The users just see selectable racket and scribble options. So if that’s what the prose tries to say, it’s inaccurate.
We should add these teaching options and make them visible, so that kids with weak keyboarding skills are
supposed to use dr are saved some work.
Let’s wait for @Robby’s list of differences. Perhaps that will help clarify what we should advertise.
Okay, following discussion I have this, let me know what y'all think (different only in the second bullet):
As of this release:
The raco setup command can generate markdown documentation, using the --doc-markdown option.
The "#lang" teaching languages have reached parity with the ones chosen using the Language dialog, and are the recommended choice. Specifically:
These languages can specify DrRacket annotation values, to enable test coverage by default.
These languages display coverage information by default in DrRacket.
These languages display source-code locations in the same way as the menu-based *SL languages.
DrRacket's background expansion disables errortrace annotations, for faster syntax checking.
The raco pkg install command includes new options that provide more install-time configuration flexibility: --adjacent-deps, --destdir, and --attach, and a refined --skip-installed.
The ffi/unsafe/runtime-lib library provides a define-runtime-lib mechanism similar to define-runtime-path, allowing location of libraries located relative to a source file.
The prompt-tag/c contract generator no longer performs checking on call/cc when the #:call/cc option is not present.
The impersonate-prompt-tag function takes an additional argument that allows checking and update of results for composable continuations.
The error-syntax->srcloc-handler parameter provides control over the mapping from syntactic forms to source locations for error handling.
Uses of (tcp-listen 0) will retry when it fails with "address in use".
The racket/base module requires fewer internal modules and instantiations.
The file/zip package provides a new mechanism for greatly increased control over zip file generation, allowing in-memory file sources and per-file compression control.
How about "Specifically: " => "The improvements in this release specifically are:" or similar and adjust the bullets to match? (this is in the #lang item)
“””
The "#lang" teaching languages have reached parity with the ones chosen using the Language dialog, and are the recommended choice. Specifically:
These languages can specify DrRacket annotation values, to enable test coverage by default.
These languages display coverage information by default in DrRacket.
These languages display source-code locations in the same way as the menu-based *SL languages.
“””
I would cut the three sub-bullets (starting with “Specifically”). Parity implies them, and we want to keep the announcements concise.
I would add "(BSL, …, ISL+; plus DeinProgram)” to the right of “teaching languages”. This should let readers know quickly for whim this item matters (or not).
I would cut the three sub-bullets (starting with “Specifically”). Parity implies them, and we want to keep the announcements concise.
Either way is fine with me,
I would add "(BSL, …, ISL+; plus DeinProgram)” to the right of “teaching languages”. This should let readers know quickly for whim this item matters (or not).
The raco setup command can generate markdown documentation, using the --doc-markdown option.
The "#lang" teaching languages (BSL, ..., ISL+; plus DeinProgram) have reached parity with the ones chosen using the Language dialog, and are the recommended choice.
DrRacket's background expansion disables errortrace annotations, for faster syntax checking.
The raco pkg install command includes new options that provide more install-time configuration flexibility: --adjacent-deps, --destdir, and --attach, and a refined --skip-installed.
The ffi/unsafe/runtime-lib library provides a define-runtime-lib mechanism similar to define-runtime-path, allowing location of libraries located relative to a source file.
The prompt-tag/c contract generator no longer performs checking on call/cc when the #:call/cc option is not present.
The impersonate-prompt-tag function takes an additional argument that allows checking and update of results for composable continuations.
The error-syntax->srcloc-handler parameter provides control over the mapping from syntactic forms to source locations for error handling.
Uses of (tcp-listen 0) will retry when it fails with "address in use".
The racket/base module requires fewer internal modules and instantiations.
The file/zip package provides a new mechanism for greatly increased control over zip file generation, allowing in-memory file sources and per-file compression control.
I don't think they are? BUT, I do see what appears to be a rendering quirk whereby a markdown link inside parentheses is not rendered as a link. Github and pygments appear to do the same thing, so I'll have to set up that link differently.
okay, I moved the link outward, so it contains the full parenthesized call to tcp-listen, and checked the render, and it looks good to me. Hopefully this is the issue you were seeing, and it's now fixed?