are docs wrong/outdated ?

[wallaceturner]

Docs for simple things like balance and contracts seem wrong:
e.g. docs for contracts

var MyContract = web3.eth.contract(abiArray);

// instantiate by address
var contractInstance = MyContract.at(address);

when in fact this doesnt work and should be

var MyContract = new web3.eth.Contract(abiArray, address);

There are plenty more examples. even something like

web3.fromWei

is supposed to be

web3.utils.fromWei

[MrTibbles]

If you are using master those docs are correct, if you are using 1.0 they are outdated and you should refer to these

[frozeman]

I added a note on top of the old docs. Thanks @MrTibbles for advising him.