Merge branch '1.x' into issue/3513

Author: ryanio

docs/web3-eth-contract.rst

@@ -986,8 +986,9 @@ methods.myMethod.encodeABI
 
     myContract.methods.myMethod([param1[, param2[, ...]]]).encodeABI()
 
-Encodes the ABI for this method. This can be used to send a transaction, call a method, or pass it into another smart contract's method as arguments.
+Encodes the ABI for this method. The resulting hex string is 32-bit function signature hash plus the passed parameters in  Solidity tightly packed format. This can be used to send a transaction, call a method, or pass it into another smart contract's method as arguments. Set the `data` field on `web3.eth.sendTransaction` options as the `encodeABI()` result and it is the same as calling the contract method with `contract.myMethod.send()`. 
 
+Some use cases for `encodeABI()` include: preparing a smart contract transaction for a multisignature wallet, working with offline wallets and cold storage and creating transaction payload for complex smart contract proxy calls.
 
 ----------
 Parameters

packages/web3-core-promievent/README.md

@@ -48,8 +48,8 @@ var myFunc = function(){
 
 // and run it
 myFunc()
+.on('done', console.log)
 .then(console.log);
-.on('done', console.log);
 ```
 
 [docs]: http://web3js.readthedocs.io/en/1.0/
@@ -59,4 +59,4 @@ myFunc()
 [deps-image]: https://david-dm.org/ethereum/web3.js/1.x/status.svg?path=packages/web3-core-promievent
 [deps-url]: https://david-dm.org/ethereum/web3.js/1.x?path=packages/web3-core-promievent
 [deps-dev-image]: https://david-dm.org/ethereum/web3.js/1.x/dev-status.svg?path=packages/web3-core-promievent
-[deps-dev-url]: https://david-dm.org/ethereum/web3.js/1.x?type=dev&path=packages/web3-core-promievent
+[deps-dev-url]: https://david-dm.org/ethereum/web3.js/1.x?type=dev&path=packages/web3-core-promievent