json-ld/json-ld.org — pull request #198 by tidoust (2012-11-14 21:30:09+00:00)
Title: Moving examples away from grammar

A few editorial updates.

As resolved in #114, I removed the examples that were in the Grammar section:
* dropping examples that already appeared elsewhere in the spec
* moving other examples to "Basic Concepts" and "Advanced Concepts" sections, possibly adding with a line of introduction when necessary.

I did not link to examples from the Grammar because:
* it already links back to the relevant sections for "further discussion" and I'm not sure how to introduce links to examples in a reader-friendly way
* ReSpec.js does not create IDs automatically for examples for the time being which makes it a bit of a pain to link to examples anyway

One thing that could be worth noting is that there is no real section that could serve as target for further discussion for the "Node definition" (soon to be renamed "Node object") section.

I also took that opportunity to set a title to examples that didn't have any (#163).