phetsims / unit-rates

"Unit Rates" is an educational simulation in HTML5, by PhET Interactive Simulations.
GNU General Public License v3.0
0 stars 2 forks source link

Dependencies.json breaks format for code review #185

Closed Denz1994 closed 7 years ago

Denz1994 commented 7 years ago

I noticed you recently added updated dependencies. It seems that other sims place their dependencies in the sim's repo at the same location. Should the code review doc be updated to include dependencies.json in the repo structure section?

Current documentation

my-repo/
      assets/
      audio/
         license.json
      doc/
         model.md
         implementation-notes.md
      images/
         license.json
      js/
         (see section below)
      .gitignore
      my-repo_en.html
      my-repo-strings_en.json
      Gruntfile.js
      LICENSE
      package.json
      README.md

Suggested change (with documentation that dependencies.json may be optional)

my-repo/
      assets/
      audio/
         license.json
      doc/
         model.md
         implementation-notes.md
      images/
         license.json
      js/
         (see section below)
      dependencies.json
      .gitignore
      my-repo_en.html
      my-repo-strings_en.json
      Gruntfile.js
      LICENSE
      package.json
      README.md

@pixelzoom

pixelzoom commented 7 years ago

dependencies.json is indeed a file that will always be in that same location. It's not generated when you create the sim via "grunt create-sim". It's generated by the build process when you "grunt deploy-dev". So it's not there until you've deployed at least 1 version. But it should be there by the time a code review starts. So, yes, please revise the code-review checklist (in phet-info) to include it.

Denz1994 commented 7 years ago

Reference https://github.com/phetsims/phet-info/commit/1ce0a66a384cadb16d9a4cb1cc995f6d050048d4 for change in documentation.