Re: 9.4 release notes

On 05/05/2014 09:38 AM, Bruce Momjian wrote:
> On Sun, May  4, 2014 at 10:24:54AM -0400, Andrew Dunstan wrote:
>> On 05/04/2014 10:12 AM, Petr Jelinek wrote:
>>> On 04/05/14 14:46, Bruce Momjian wrote:
>>>> I have completed the initial version of the 9.4 release notes.  You can
>>>> view them here:
>>>>
>>>>     http://www.postgresql.org/docs/devel/static/release-9-4.html
>>>>
>>>> I will be adding additional markup in the next few days.
>>>>
>>>> Feedback expected and welcomed.  I expect to be modifying this until we
>>>> release 9.4 final.  I have marked items where I need help with question
>>>> marks.
>>>>
>>> Nice work,
>>>
>>> one comment from me would be about jsonb:
>>>
>>> +       <listitem>
>>> +        <para>
>>> +         Add structured (non-text) data type (jsonb) for storing
>>> JSON data (Oleg Bartunov,  Teodor Sigaev, Peter Geoghegan and
>>> Andrew Dunstan)
>>> +        </para>
>>> +
>>> +        <para>
>>> +         This data type allows faster indexing and access to json
>>> keys/value pairs.
>>> +        </para>
>>> +       </listitem>
>>>
>>> I think the explanation should be expanded to say that this data
>>> type also has generic indexing not just faster indexing.
>>>
>>
>> It's also slightly ambiguous - it's not immediately clear that the
>> "faster" also applies to the "access".
> OK, how is this:
>
>           This data type allows for faster indexing and access to json
>           key/value pairs, as well as efficient indexing of all key/value
>           pairs in a JSON document.
>

No, I think you're missing the point of what I'm saying, and I think the 
addition is at best misleading. I would avoid talk of key value pairs, 
anyway, that's not all that's in a json document (it might be an array, 
for example).

How about:
   This data type allows for faster access to values in the json document and faster and more useful indexing of json.

cheers

andrew