Re: [Json] Generators

[Marcos Caceres <[e-mail]>]

On Monday, 10 June 2013 at 10:49, Markus Lanthaler wrote:

> On Monday, June 10, 2013 9:38 AM, Stefan Drees wrote:
> > 5. Generators
> >  
> > A JSON generator produces JSON text that MUST strictly conform to
> > the JSON grammar.
>  

Please try to avoid "wish list" style conformance requirements. If you want "strictly" conforming documents generated (whatever that may mean), then please write the algorithm to produce such documents. For example:

"When generating JSON, as JSON generator MUST run the steps to generate JSON text.

The steps to generate JSON text are given by the following algorithm:  
1. …
2. …  
"

> >  
> > Generators MUST NOT duplicate names in objects if they can avoid or
> > detect such duplication.
> >  
> > """
> [...]
> > This "MUST NOT duplicate ... if" reads pretty soft for implementers,
> > but should be the only consensual non-breaking way out of the
> > historical dilemma of not enforcing it for generators in the first place.
>  

I agree. The above "if they can avoid [it]" if pretty lousy spec text. Please define the algorithm instead to produce the results you want.  

For excellent examples of how to write a specification using step-based conformance, please see the ES6 spec. See the parsing algorithm for JSON here - you basically want a language neutral version of that, right?:

http://people.mozilla.org/~jorendorff/es6-draft.html#sec-15.12.2

HTH,  
Marcos Caceres