cue-lang / docs-and-content

A place to discuss, plan, and track documentation on cuelang.org
5 stars 1 forks source link

tutorial: Using cue import to convert {JSON,YAML} files to CUE #66

Open jpluscplusm opened 7 months ago

jpluscplusm commented 7 months ago

In docs/concept/{json,yaml}/ we noticed the lack of candidate pages to link to, in order to demonstrate cue import (other than the autogenerated CLI docs).

This pair of guides could show the progression through:

  1. single file import
  2. multi-file import, where all files unify successfully
  3. multi-file import, where the data needs to be placed appropriately because multiple instances don't unify successfully

The YAML guide could also demonstrate (2) and/or (3) with a multi-document file.