fix: improved docs

Author: bhovhannes

README.md

@@ -31,9 +31,9 @@ console.log(util.inspect(Workfront, {depth:0}));
 
 #### In a browser
 
-This package uses [Browserify](http://browserify.org) to generate [dist/workfront.min.js](dist/workfront.min.js). Loading that script will create `window.Workfront` object which will contain all the classes and methods just as in the server-side environment (see [Server-side](#server-side) section).
-This package makes use of [Promises](https://www.promisejs.org). Promises are not currently supported by all browsers (see [kangax compatibility tables](http://kangax.github.io/compat-table/es6/#Promise)), but there are many polyfills available, including one listed in [www.promisejs.org](https://www.promisejs.org). Load polyfill before `workfront.min.js` and everything will work just fine.
-Although the lack of CORS support may prevent you from sending request to Workfront servers, there are some usage examples in [examples/browser](examples/browser) folder to give you an idea.
+This package uses [Browserify](http://browserify.org) to generate [dist/workfront.min.js](dist/workfront.min.js). Loading that script will create `window.Workfront` object which will contain all the classes and methods just as in the server-side environment (see [Server-side](#server-side) section).  
+This package makes use of [Promises](https://www.promisejs.org). Promises are not currently supported by all browsers (see [kangax compatibility tables](http://kangax.github.io/compat-table/es6/#Promise)), but there are many polyfills available, including one listed in [www.promisejs.org](https://www.promisejs.org). Load polyfill before `workfront.min.js` and everything will work just fine.  
+Although the lack of CORS support may prevent you from sending request to Workfront servers, there are some usage examples in [examples/browser](examples/browser) folder to give you an idea.  
 Note, that it is still possible to make use of this package in privileged environment such as browser extensions.
 
 

src/plugins/upload.js

@@ -26,6 +26,7 @@ module.exports = function(Api) {
      * Starting from version 2.0 API allows users to upload files.
      * The server will return the JSON data which includes 'handle' of uploaded file.
      * Returned 'handle' can be passed to create() method to create a new document.
+     * This method is not available for browser execution environments and it is available only for Node.
      * @memberOf Workfront.Api
      * @param {fs.ReadStream} stream    A readable stream with file contents
      * @param {Object} [overrides] Override the filename and content type (using keys