adjust file doc string for accuracy
move interpolate function to util_unused
fall back to json if simplejson isn't available
flowchart overview of planeteria pieces
fill paragraphs
note the overview.dia in README