Update contributor docs and add comments

Author: akshay-99

Gruntfile.js

@@ -562,7 +562,9 @@ module.exports = grunt => {
   ]);
   grunt.registerTask('yui:build', ['yui']);
 
-  // builds the docs and the library before release
+  // This is called by the "prepublishOnly" script in package.json to build the
+  // documentation and the library after np bumps up the version number so that
+  // the newly built files with the updated version number can be published.
   grunt.registerTask('prerelease', ['yui', 'build']);
 
   grunt.registerTask('default', ['lint-no-fix', 'test']);

contributor_docs/release_process.md

@@ -23,14 +23,14 @@ npm run release
 * `np` will then reinstall `node_modules` then run tests with `npm test`.
 * `np` will bump the version according to what was selected at the beginning.
 * If any step prior to this failed, the repo will be reverted to its initial state before running `npm run release`.
+* The task mentioned in `prepublishOnly` in `package.json` will run ( `grunt prerelease` ) to build the documentation and the library with the updated version number
 * The NPM package is published.
 	* Release on NPM : __Only__ the files mentioned in `files` in `package.json` are published.
 * Tags and local commits are pushed to the git remote.
 * A draft release is created on github.com with changelogs that can be edited.
 * Create a Zip file `p5.zip` of `lib` folder (now includes the empty example), which should be uploaded in the GitHub Release draft created above.
 	* After this process completes a window pointing at `release/` will open and it will contain all the files that should be uploaded as part of the Github Release.
 * Push the newly built library to [p5.js-release](https://github.com/processing/p5.js-release) repo for Bower.
-* Building the Docs: This is run as `grunt yui`
 * Push the newly built reference to [p5.js-website](https://github.com/processing/p5.js-website)
 
 ## Testing

tasks/build/browserify.js

@@ -38,6 +38,9 @@ module.exports = function(grunt) {
       });
 
       if (isMin) {
+        // These paths should be the exact same as what are used in the import
+        // statements in the source. They are not relative to this file. It's
+        // just how browserify works apparently.
         browseified = browseified
           .exclude('../../docs/reference/data.json')
           .exclude('../../../docs/parameterData.json')