Re: [TCLCORE] Tcl/Tk 8.6.15 release announcement review

[Donald G P. <don...@ni...>]

On 9/14/24 04:17, elns wrote:
> 1. Regarding the word "Highlighted" in the paragraph:
>
> "This is a patch release, so it primarily includes bug fixes and corrections
> to erratic behavior.  Highlighted changes are noted below.  The changes file
> at the root of the source tree contains a more complete list.  The Timelines
> of all changes are online."
>
> Is this word appropriate? I'm not a native English speaker. So, I'm unsure. Nevertheless: this word makes me understand that (in the past) somebody or something has made some selected changes stand out (e.g. with a marker pen), and that in a next pass/stage these changes have been chosen for display in the summary of changes. I'm confident that that's not what was meant, but I'm not confident enough to suggest an alternative wording.

The important point is that the contents of the release notes are not exhaustive.  The text goes on to point to the online Timelines as the place to see every change.  A selection process reduced the total set of changes to those summarized in the announcement.  I don't see a need to change the wording.

> 2. A suggestions to organize the summary of changes in the following distinct categories:
>        A. Tcl
>        B. Tk
>        C. Additional packages

The release notes for versions 9 will look more like this, as we support
separate releases of these components.  I will not revise the 8.6.15 notes
along these lines.

-- 
| Don Porter            Applied and Computational Mathematics Division |
| don...@ni...             Information Technology Laboratory |
| http://math.nist.gov/~DPorter/                                  NIST |
|______________________________________________________________________|