Update and simplify README

Update and simplify README

Remove obsolete info and simplify remaining info regarding
installing dependencies.

https://code.launchpad.net/~michael.nelson/juju-core/update-readme/+merge/179165

(do not edit description out of merge proposal)

[Michael Nelson, 2013-08-08 11:38:01]

Please take a look.

[Michael Nelson, 2013-08-08 11:39:17]

Please take a look.

[dimitern, 2013-08-08 11:58:05]

LGTM with a couple of comments.

https://codereview.appspot.com/12659043/diff/5001/README
File README (left):

https://codereview.appspot.com/12659043/diff/5001/README#oldcode68
README:68: http://juju-dist.s3.amazonaws.com/tools/mongo-2.2.0-precise-amd64.tgz
I think this mongo version is still the only one that works, so it shouldn't be
removed. Have you tested it works without it?

https://codereview.appspot.com/12659043/diff/5001/README
File README (right):

https://codereview.appspot.com/12659043/diff/5001/README#newcode106
README:106: sudo juju bootstrap
I don't think you need sudo to do bootstrap.

[rog, 2013-08-08 12:10:00]

I like the motivation, but I'm not entirely sure
about the result. Some thoughts below.

https://codereview.appspot.com/12659043/diff/5001/README
File README (left):

https://codereview.appspot.com/12659043/diff/5001/README#oldcode117
README:117: --upload-tools
I'm not entirely sure about removing this info, as it's
very useful if wanting to actually use juju for real.

If we're going to remove it from here, perhaps we should
insert some links to where the more comprehensive documentation
lives.

https://codereview.appspot.com/12659043/diff/5001/README
File README (right):

https://codereview.appspot.com/12659043/diff/5001/README#newcode106
README:106: sudo juju bootstrap
On 2013/08/08 11:58:05, dimitern wrote:
> I don't think you need sudo to do bootstrap.

presumably you when using the local provider, because
LXC must run as root.

but this is then a bad example, because it
might make the first-time user assume that
juju always needs to run as root.

[Michael Nelson, 2013-08-08 12:35:51]

Please take a look.

https://codereview.appspot.com/12659043/diff/5001/README
File README (left):

https://codereview.appspot.com/12659043/diff/5001/README#oldcode68
README:68: http://juju-dist.s3.amazonaws.com/tools/mongo-2.2.0-precise-amd64.tgz
On 2013/08/08 11:58:05, dimitern wrote:
> I think this mongo version is still the only one that works, so it shouldn't
be
> removed. Have you tested it works without it?

Yeah - seems to work with the ppa:juju/experimental mongodb-server version
(2.2.4):

http://paste.ubuntu.com/5962430/

https://codereview.appspot.com/12659043/diff/5001/README#oldcode117
README:117: --upload-tools
On 2013/08/08 12:10:00, rog wrote:
> I'm not entirely sure about removing this info, as it's
> very useful if wanting to actually use juju for real.
> 
> If we're going to remove it from here, perhaps we should
> insert some links to where the more comprehensive documentation
> lives.

k - I only removed i wrongly assumed it was no longer necessary. Added back in.

https://codereview.appspot.com/12659043/diff/5001/README
File README (right):

https://codereview.appspot.com/12659043/diff/5001/README#newcode106
README:106: sudo juju bootstrap
On 2013/08/08 11:58:05, dimitern wrote:
> I don't think you need sudo to do bootstrap.

As rog says, for local you currently do.

https://codereview.appspot.com/12659043/diff/5001/README#newcode106
README:106: sudo juju bootstrap
On 2013/08/08 12:10:00, rog wrote:
> On 2013/08/08 11:58:05, dimitern wrote:
> > I don't think you need sudo to do bootstrap.
> 
> presumably you when using the local provider, because
> LXC must run as root.
> 
> but this is then a bad example, because it
> might make the first-time user assume that
> juju always needs to run as root.

I'm not sure of a better example though. This should just work without any
further configuration (unlike other providers).

What if I add a note about the use of sudo for local bootstrap only? Otherwise I
can remove the example - let me know.

[rog, 2013-08-12 12:31:13]

LGTM with one suggestion below

https://codereview.appspot.com/12659043/diff/10001/README
File README (right):

https://codereview.appspot.com/12659043/diff/10001/README#newcode104
README:104: provider, as the local container is created in /var/lib/lxc):
(Note: the use of sudo for bootstrap here is only required for the local
provider because it uses LXC, which requires root privileges)

?

[fwereade, 2013-08-13 09:24:44]

just a comment

https://codereview.appspot.com/12659043/diff/10001/Makefile
File Makefile (right):

https://codereview.appspot.com/12659043/diff/10001/Makefile#newcode21
Makefile:21: @sudo apt-add-repository ppa:juju/experimental
I think this should be "stable" now, shouldn't it?

[Michael Nelson, 2013-08-13 09:39:36]

Please take a look.

https://codereview.appspot.com/12659043/diff/10001/Makefile
File Makefile (right):

https://codereview.appspot.com/12659043/diff/10001/Makefile#newcode21
Makefile:21: @sudo apt-add-repository ppa:juju/experimental
On 2013/08/13 09:24:44, fwereade wrote:
> I think this should be "stable" now, shouldn't it?

Yes - now that mongodb is there. Updating.

https://codereview.appspot.com/12659043/diff/10001/README
File README (right):

https://codereview.appspot.com/12659043/diff/10001/README#newcode104
README:104: provider, as the local container is created in /var/lib/lxc):
On 2013/08/12 12:31:13, rog wrote:
> (Note: the use of sudo for bootstrap here is only required for the local
> provider because it uses LXC, which requires root privileges)
> 
> ?

Done.