Thread: PostgreSQL 11 Press Release Feedback

PostgreSQL 11 Press Release Feedback

From
"Jonathan S. Katz"
Date:
Hi,

As we have recently released PostgreSQL 11 Beta 3, the time to releasing
PostgreSQL 11 is drawing near. I wanted to share with you a draft of the
proposed press release to solicit *constructive* feedback, specifically looking
for:

- Grammatical mistakes / typos / awkward + unclear language
- Technical inaccuracies
- Suggestions for missing features that should be highlighted
- Quotes - you can see there are lots of room for them ;-)

Please bear in mind that the release is targeted towards the users of
PostgreSQL, the vast majority of whom do not post to the mailing lists, and the
principle idea behind the language is to help clearly explain why one should
upgrade, if not use, PostgreSQL 11 and how to utilize the new features
available. For many people, this is their only viewpoint into whats in the
release, so let's make sure it makes them excited about using PostgreSQL!

If you wish to provide feedback, please send it no later than Aug 31, 2018.
After that, the draft will need to be finalized (barring changes from -hackers
on which features are included).

If you wish to provide a quote, please send an
email to press@postgresql.org with your name, organization, and the quote.

Below is a copy of the press release draft:


Thanks for your help,

Jonathan

Attachment

Re: PostgreSQL 11 Press Release Feedback

From
Sarah Schnurr
Date:
On Wed, Aug 22, 2018 at 8:41 AM Jonathan S. Katz <jkatz@postgresql.org> wrote:
Hi,

As we have recently released PostgreSQL 11 Beta 3, the time to releasing
PostgreSQL 11 is drawing near. I wanted to share with you a draft of the
proposed press release to solicit *constructive* feedback, specifically looking
for:

- Grammatical mistakes / typos / awkward + unclear language
- Technical inaccuracies
- Suggestions for missing features that should be highlighted
- Quotes - you can see there are lots of room for them ;-)

Please bear in mind that the release is targeted towards the users of
PostgreSQL, the vast majority of whom do not post to the mailing lists, and the
principle idea behind the language is to help clearly explain why one should
upgrade, if not use, PostgreSQL 11 and how to utilize the new features
available. For many people, this is their only viewpoint into whats in the
release, so let's make sure it makes them excited about using PostgreSQL!

If you wish to provide feedback, please send it no later than Aug 31, 2018.
After that, the draft will need to be finalized (barring changes from -hackers
on which features are included).

If you wish to provide a quote, please send an
email to press@postgresql.org with your name, organization, and the quote.

Below is a copy of the press release draft:


Thanks for your help,

Jonathan


Jonathan,

Overall, the post is phrased and written extremely well. It is very informative and concise. 

With that said, there are three minor typos that I caught on a quick read-through:

Period is on a different line.

  40 to the correct partition if the partition key for that row is updated
  41 .
 
I believe it should be "to enable" here.

  91 To take advantage of JIT compilation, you will need to install the LLVM
  92 dependencies enable JIT compilation in either your PostgreSQL settings file by
  93 setting `jit = on` or from your PostgreSQL session by executing `SET jit = on`.
 
Additional functionality*.

 108 - Additional functionally for working with window functions, including allowing
 109 `RANGE` to use `PRECEDING`/`FOLLOWING`, `GROUPS`, and frame exclusion

Hopefully this helps!

--
Sarah Schnurr

Re: PostgreSQL 11 Press Release Feedback

From
"Jonathan S. Katz"
Date:
Hi Sarah,

On Aug 22, 2018, at 11:55 AM, Sarah Schnurr <xenophenes42@gmail.com> wrote:

Overall, the post is phrased and written extremely well. It is very informative and concise. 

Thank you!

With that said, there are three minor typos that I caught on a quick read-through:

Period is on a different line.

  40 to the correct partition if the partition key for that row is updated
  41 .
 
I believe it should be "to enable" here.

  91 To take advantage of JIT compilation, you will need to install the LLVM
  92 dependencies enable JIT compilation in either your PostgreSQL settings file by
  93 setting `jit = on` or from your PostgreSQL session by executing `SET jit = on`.
 
Additional functionality*.

 108 - Additional functionally for working with window functions, including allowing
 109 `RANGE` to use `PRECEDING`/`FOLLOWING`, `GROUPS`, and frame exclusion

Hopefully this helps!

Thank you, that was indeed very helpful and what we’re looking for in
this process. I’ve gone ahead and pushed those fixes.

Thanks!

Jonathan

Attachment

Re: PostgreSQL 11 Press Release Feedback

From
Amit Langote
Date:
Hi Jonathan,

Thanks for working on this.

On 2018/08/23 0:40, Jonathan S. Katz wrote:
> Hi,
> 
> As we have recently released PostgreSQL 11 Beta 3, the time to releasing
> PostgreSQL 11 is drawing near. I wanted to share with you a draft of the
> proposed press release to solicit *constructive* feedback, specifically looking
> for:
> 
> - Grammatical mistakes / typos / awkward + unclear language
> - Technical inaccuracies
> - Suggestions for missing features that should be highlighted
> - Quotes - you can see there are lots of room for them ;-)
> 
> Please bear in mind that the release is targeted towards the users of
> PostgreSQL, the vast majority of whom do not post to the mailing lists, and the
> principle idea behind the language is to help clearly explain why one should
> upgrade, if not use, PostgreSQL 11 and how to utilize the new features
> available. For many people, this is their only viewpoint into whats in the
> release, so let's make sure it makes them excited about using PostgreSQL!
> 
> If you wish to provide feedback, please send it no later than Aug 31, 2018.
> After that, the draft will need to be finalized (barring changes from -hackers
> on which features are included).
> 
> If you wish to provide a quote, please send an
> email to press@postgresql.org with your name, organization, and the quote.
> 
> Below is a copy of the press release draft:

About the following:

"PostgreSQL 11 also supports partitioned tables that utilize the
PostgreSQL foreign data wrapper,
[postgres_fdw](https://www.postgresql.org/docs/current/static/postgres-fdw.html),
enabling users to combine partitioning with data federation techniques."

Just to clarify, we support partitioned tables containing partitions that
utilize FDWs even in PostgreSQL 10 [1].  Although, they were not handled
by tuple routing, so offered limited functionality as partitions.
PostgreSQL 11 fixed that limitation, which makes them more useful.

Thanks,
Amit

[1] https://www.postgresql.org/docs/10/static/sql-createforeigntable.html



Re: PostgreSQL 11 Press Release Feedback

From
"Jonathan S. Katz"
Date:
Hi Amit,

On Aug 22, 2018, at 9:12 PM, Amit Langote <Langote_Amit_f8@lab.ntt.co.jp> wrote:

Hi Jonathan,

Thanks for working on this.

On 2018/08/23 0:40, Jonathan S. Katz wrote:
Hi,

As we have recently released PostgreSQL 11 Beta 3, the time to releasing
PostgreSQL 11 is drawing near. I wanted to share with you a draft of the
proposed press release to solicit *constructive* feedback, specifically looking
for:

- Grammatical mistakes / typos / awkward + unclear language
- Technical inaccuracies
- Suggestions for missing features that should be highlighted
- Quotes - you can see there are lots of room for them ;-)

Please bear in mind that the release is targeted towards the users of
PostgreSQL, the vast majority of whom do not post to the mailing lists, and the
principle idea behind the language is to help clearly explain why one should
upgrade, if not use, PostgreSQL 11 and how to utilize the new features
available. For many people, this is their only viewpoint into whats in the
release, so let's make sure it makes them excited about using PostgreSQL!

If you wish to provide feedback, please send it no later than Aug 31, 2018.
After that, the draft will need to be finalized (barring changes from -hackers
on which features are included).

If you wish to provide a quote, please send an
email to press@postgresql.org with your name, organization, and the quote.

Below is a copy of the press release draft:

About the following:

"PostgreSQL 11 also supports partitioned tables that utilize the
PostgreSQL foreign data wrapper,
[postgres_fdw](https://www.postgresql.org/docs/current/static/postgres-fdw.html),
enabling users to combine partitioning with data federation techniques."

Just to clarify, we support partitioned tables containing partitions that
utilize FDWs even in PostgreSQL 10 [1].  Although, they were not handled
by tuple routing, so offered limited functionality as partitions.
PostgreSQL 11 fixed that limitation, which makes them more useful.

Thanks for the clarification! Would something like “PostgreSQL 11 _provides better
support for_…” work better?

Jonathan

Attachment

Re: PostgreSQL 11 Press Release Feedback

From
Amit Langote
Date:
On 2018/08/23 13:09, Jonathan S. Katz wrote:
>> On Aug 22, 2018, at 9:12 PM, Amit Langote <Langote_Amit_f8@lab.ntt.co.jp> wrote:
>>> Below is a copy of the press release draft:
>>
>> About the following:
>>
>> "PostgreSQL 11 also supports partitioned tables that utilize the
>> PostgreSQL foreign data wrapper,
>> [postgres_fdw](https://www.postgresql.org/docs/current/static/postgres-fdw.html
<https://www.postgresql.org/docs/current/static/postgres-fdw.html>),
>> enabling users to combine partitioning with data federation techniques."
>>
>> Just to clarify, we support partitioned tables containing partitions that
>> utilize FDWs even in PostgreSQL 10 [1].  Although, they were not handled
>> by tuple routing, so offered limited functionality as partitions.
>> PostgreSQL 11 fixed that limitation, which makes them more useful.
> 
> Thanks for the clarification! Would something like “PostgreSQL 11 _provides better
> support for_…” work better?

Maybe, "PostgreSQL 11 enhances the foreign partition functionality offered
via its PostgreSQL foreign data wrapper [postgres_fdw] ..."?

Thanks,
Amit



Re: PostgreSQL 11 Press Release Feedback

From
Peter Eisentraut
Date:
This is a bit strange:

  59 SQL procedures can be created using the `CREATE PROCEDURE` command,
executed
  60 using the `CALL` command, and are supported in the server-side
procedural
  61 languages PL/pgSQL, PL/Perl, PL/Python, PL/Tcl, and the Server
Programming
  62 Interface (SPI) languages.

The stuff about SPI should probably be removed.

-- 
Peter Eisentraut              http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services


Re: PostgreSQL 11 Press Release Feedback

From
"Jonathan S. Katz"
Date:
> On Aug 23, 2018, at 12:43 AM, Amit Langote <Langote_Amit_f8@lab.ntt.co.jp> wrote:
>
> On 2018/08/23 13:09, Jonathan S. Katz wrote:
>>> On Aug 22, 2018, at 9:12 PM, Amit Langote <Langote_Amit_f8@lab.ntt.co.jp> wrote:
>>>> Below is a copy of the press release draft:
>>>
>>> About the following:
>>>
>>> "PostgreSQL 11 also supports partitioned tables that utilize the
>>> PostgreSQL foreign data wrapper,
>>> [postgres_fdw](https://www.postgresql.org/docs/current/static/postgres-fdw.html
<https://www.postgresql.org/docs/current/static/postgres-fdw.html>),
>>> enabling users to combine partitioning with data federation techniques."
>>>
>>> Just to clarify, we support partitioned tables containing partitions that
>>> utilize FDWs even in PostgreSQL 10 [1].  Although, they were not handled
>>> by tuple routing, so offered limited functionality as partitions.
>>> PostgreSQL 11 fixed that limitation, which makes them more useful.
>>
>> Thanks for the clarification! Would something like “PostgreSQL 11 _provides better
>> support for_…” work better?
>
> Maybe, "PostgreSQL 11 enhances the foreign partition functionality offered
> via its PostgreSQL foreign data wrapper [postgres_fdw] …"?

Thanks for the suggestion. I pushed some changes taking ideas from the
above.

Jonathan


Attachment

Re: PostgreSQL 11 Press Release Feedback

From
"Jonathan S. Katz"
Date:
> On Aug 23, 2018, at 12:56 PM, Peter Eisentraut <peter.eisentraut@2ndquadrant.com> wrote:
>
> This is a bit strange:
>
>  59 SQL procedures can be created using the `CREATE PROCEDURE` command,
> executed
>  60 using the `CALL` command, and are supported in the server-side
> procedural
>  61 languages PL/pgSQL, PL/Perl, PL/Python, PL/Tcl, and the Server
> Programming
>  62 Interface (SPI) languages.
>
> The stuff about SPI should probably be removed.

Thanks - changes pushed.

Jonathan


Attachment