Re: PostgreSQL 12: Feature Highlights

--000000000000f931b60589251233
Content-Type: text/plain; charset="UTF-8"

On Fri, May 17, 2019 at 4:31 PM Jonathan S. Katz <[email protected]>
wrote:

> On 5/17/19 10:19 AM, Bruce Momjian wrote:
> > On Fri, May 17, 2019 at 08:14:33AM -0400, Evan Macbeth wrote:
> >> Long time lurker, first time poster. :)
> >>
> >>
> >>     80% - 90% of the items listed in the release notes aren't
> interesting
> >>     to users, but *which* 80% - 90% it is varies. The release notes
> don't
> >>     have to function as a press release, because we'll have an actual
> >>     press release instead.
> >>     --
> >>     Peter Geoghegan
> >>
> >>
> >> I think Peter's point here is really important. I read the release
> notes and
> >> the press releases, both, from a very different perspective than
> others, but I
> >> find both very valuable. The release notes benefit from completeness and
> >> detail, in my observer's opinion.
> >
> > As I just stated, if the press release was exhaustive, we could have the
> > release notes be more detailed, but this is not the case.  I don't think
> > we want to get into a case where the items listed on the preess release
> > get a different level of detail from the items not listed.
>
> To step back, it's important to understand the intended goals of the
> press release.
>
> I view the primary goal of the press release for a major version to be a
> springboard to further dive into what is in the release. It helps to
> give some global context to new features / changes and is an effective
> "getting started" point. It needs just enough details for people to be
> interested, and if they want more info, they can go to the release notes
> + docs.
>
> The release notes then can provide additional details on what said
> features (effectively a readable "diff" between versions) are, and, if
> needed, the documentation can provide even greater details.
>

There is in fact a third layer to consider as well, which is the release
announcement. This can (and sometimes are) different from the press release.

So you have the press release. Then more details can be added to the
release announcement. Then even more details can be added to the release
notes.

-- 
 Magnus Hagander
 Me: https://www.hagander.net/ <http://www.hagander.net/>
 Work: https://www.redpill-linpro.com/ <http://www.redpill-linpro.com/>

--000000000000f931b60589251233
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div dir=3D"ltr">On Fri, May 17, 2019 at 4:31 PM Jonathan =
S. Katz &lt;<a href=3D"mailto:[email protected]">[email protected]</a=
>&gt; wrote:<br></div><div class=3D"gmail_quote"><blockquote class=3D"gmail=
_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204=
,204);padding-left:1ex">On 5/17/19 10:19 AM, Bruce Momjian wrote:<br>
&gt; On Fri, May 17, 2019 at 08:14:33AM -0400, Evan Macbeth wrote:<br>
&gt;&gt; Long time lurker, first time poster. :)=C2=A0<br>
&gt;&gt;<br>
&gt;&gt;<br>
&gt;&gt;=C2=A0 =C2=A0 =C2=A080% - 90% of the items listed in the release no=
tes aren&#39;t interesting<br>
&gt;&gt;=C2=A0 =C2=A0 =C2=A0to users, but *which* 80% - 90% it is varies. T=
he release notes don&#39;t<br>
&gt;&gt;=C2=A0 =C2=A0 =C2=A0have to function as a press release, because we=
&#39;ll have an actual<br>
&gt;&gt;=C2=A0 =C2=A0 =C2=A0press release instead.<br>
&gt;&gt;=C2=A0 =C2=A0 =C2=A0--<br>
&gt;&gt;=C2=A0 =C2=A0 =C2=A0Peter Geoghegan<br>
&gt;&gt;<br>
&gt;&gt;<br>
&gt;&gt; I think Peter&#39;s point here is really important. I read the rel=
ease notes and<br>
&gt;&gt; the press releases, both, from a very different perspective than o=
thers, but I<br>
&gt;&gt; find both very valuable. The release notes benefit from completene=
ss and<br>
&gt;&gt; detail, in my observer&#39;s opinion.<br>
&gt; <br>
&gt; As I just stated, if the press release was exhaustive, we could have t=
he<br>
&gt; release notes be more detailed, but this is not the case.=C2=A0 I don&=
#39;t think<br>
&gt; we want to get into a case where the items listed on the preess releas=
e<br>
&gt; get a different level of detail from the items not listed.<br>
<br>
To step back, it&#39;s important to understand the intended goals of the<br=
>
press release.<br>
<br>
I view the primary goal of the press release for a major version to be a<br=
>
springboard to further dive into what is in the release. It helps to<br>
give some global context to new features / changes and is an effective<br>
&quot;getting started&quot; point. It needs just enough details for people =
to be<br>
interested, and if they want more info, they can go to the release notes<br=
>
+ docs.<br>
<br>
The release notes then can provide additional details on what said<br>
features (effectively a readable &quot;diff&quot; between versions) are, an=
d, if<br>
needed, the documentation can provide even greater details.<br></blockquote=
><div><br></div><div>There is in fact a third layer to consider as well, wh=
ich is the release announcement. This can (and sometimes are) different fro=
m the press release.</div><div><br></div><div>So you have the press release=
. Then more details can be added to the release announcement. Then even mor=
e details can be added to the release notes.</div><div><br></div></div>-- <=
br><div dir=3D"ltr" class=3D"gmail_signature"><div dir=3D"ltr"><div>=C2=A0M=
agnus Hagander<br>=C2=A0Me: <a href=3D"http://www.hagander.net/" target=3D"=
_blank">https://www.hagander.net/</a><br>=C2=A0Work: <a href=3D"http://www.=
redpill-linpro.com/" target=3D"_blank">https://www.redpill-linpro.com/</a><=
/div></div></div></div>

--000000000000f931b60589251233--