remove docs referencing 'new' from index

Signed-off-by: Alfredo Deza <alfredo.deza@inktank.com>
add new.rst to the contents toc tree

Signed-off-by: Alfredo Deza <alfredo.deza@inktank.com>
create a new.rst file for the new subcommand

Signed-off-by: Alfredo Deza <alfredo.deza@inktank.com>
add example to docstring for ip_addresses

Signed-off-by: Alfredo Deza <alfredo.deza@inktank.com>
prefer the public network IP if --public-network is used

which will connect to the remote node, fetch all the IPs and
pick the one that matches the subnet

Signed-off-by: Alfredo Deza <alfredo.deza@inktank.com>