Re: Split JSON-LD spec

On Sep 1, 2011, at 8:32 AM, Markus Lanthaler wrote:

> Hi all,
> 
> I thought a bit more about the recent discussions here on the mailing list
> and came to the conclusion that it might be better to split the JSON-LD spec
> into two parts:
> 
> 1. JSON-LD (the language)
> 2. JSON-LD Processing (APIs, algorithms, etc.)
> 
> I think doing so would reflect the fact that different people are interested
> in different aspects of JSON-LD. Of course, everyone has to understand
> JSON-LD the language, thus we should really put a strong emphasis on a
> simple, short, and easy to understand spec for that.

+1 It is important for adoption that the core use of JSON-LD be as simple as possible and directed towards potential adopters of the language, rather than the fewer implementers.

> On the other hand there are some other aspects which I think are also
> important to standardize (think normalization, framing, etc.) but which are
> much more complex and only a few people actually have to read and understand
> how all this works.
> 
> In my opinion, splitting the spec would definitely be beneficial for the
> adoption of JSON-LD. It also allows us to get more insights (and time) for
> the tricky parts if we release the JSON-LD language spec first. Designing
> good APIs for something that hasn't existed and hasn't been used before is
> not a trivial task.
> 
> Please note that I'm strictly against about having a basic and an advanced
> spec. Think of it more as "separation of concerns".
> 
> 
> If there is enough interest, I will create a draft of the specs as a base
> for further discussion.

It should be fairly straightforward to separate the current document. It would be great if you took a stab at that, although there will inevitably be elements that need to exist in both documents. Perhaps add language/ and processing/ directories to /spec. While we're at it, we should probably keep the source in a separate file, so the index can be easily generated. How about the following:

spec/
	language/
		latest/
			source.html
			index.html
		drafts/
			20110901/
				source.html
				index.html
				diffs.html
	processing/
		latest/
			...

> --
> Markus Lanthaler
> @markuslanthaler
> 
> 
> 
> 
> 

Received on Thursday, 1 September 2011 16:25:05 UTC