Re: The netsec thread

[Eli Zaretskii]

> From: Robert Pluim <address@hidden>
> Cc: address@hidden,  address@hidden
> Date: Fri, 23 Aug 2019 16:27:59 +0200
> 
>     Eli> If this is your interpretation of what NEWS says, then we must modify
>     Eli> that text to be less ambiguous.  "+++" means the doc strings AND the
>     Eli> manuals have been updated, "---" means the doc string WITHOUT manuals
>     Eli> were updated.
> 
> That was indeed my interpretation.
> 
>     Eli> These markers are there for when we are close to releasing a new 
> major
>     Eli> version, and need to make sure everything that needs to be in the
>     Eli> manuals is in the manuals.  It therefore makes no sense to mark by
>     Eli> "+++" changes that do not need to be in the manuals, because that
>     Eli> sends the wrong signal.
> 
> So in this case weʼd use '---'.

Yes.

> Itʼs all clear to me now, but youʼre right that perhaps a different
> wording would be better (of course it could just be a problem in my
> brain :-) )

If you can suggest a better wording, please do.  One possible way is
to simply remove the reference to the doc strings, as they are not
relevant to the job these markers should do (doc strings should be
adjusted as part of any change).