How do you document your JSON-LD context files ?

Hello

How do people here document their JSON-LD context file ?
JSON prohibits the use of comments. JSON-LD prohibits the use of unknown
keys in the context.

I frequently need to :
  - group context declarations in sections (like in
https://www.w3.org/TR/annotation-vocab/#json-ld-context), and document
these sections
  - document specific mappings, e.g. add a comment to explain why this
mapping uses @container and what are the consequences:

    "identifiedBy" : {
      "@id" : "bf:identifiedBy",
      "@type" : "@id",
      "@container": "@id"
    },

Kind Regards
Thomas

-- 

*Thomas Francart* -* SPARNA*
Web de *données* | Architecture de l'*information* | Accès aux
*connaissances*
blog : blog.sparna.fr, site : sparna.fr, linkedin :
fr.linkedin.com/in/thomasfrancart
tel :  +33 (0)6.71.11.25.97, skype : francartthomas