How should we document/describe build-local.json?

[zepumph]

Very similar from #913 (comment), we may want to apply the pattern developed over there for package.json files to build-local.json. Marking on hold for now.

Also during the meeting @samreid mentioned that we support a schema-type module for our build-local.json, but that is not true from what I see here in chipper's Gruntfile.js:

  // Handle the lack of build.json
  let buildLocal;
  try {
    buildLocal = grunt.file.readJSON( process.env.HOME + '/.phet/build-local.json' );
  }
  catch( e ) {
    buildLocal = {};
  }

Perhaps the next step will be to do the same thing for build-local.

[samreid]

We have this: perennial/js/common/buildLocal.js, but perhaps it isn't used everywhere it could or should be?

[zepumph]

Oh I see! I didn't find it in chipper! Perhaps we can use the same sort of pattern as was discussed in #913 to make this available to chipper's grunt file as well. This will be more consistent for all repos.