Update provisioning internals docs

 - Placement directives
 - Availability zone spread

Also, changed to use Markdown format.
Merge pull request #679 from voidspace/waitfor-replicaset

Remove the Remove

replicaset/replicaset_test : get rid of extraneous calls to Remove

Remove is a slow operation, and we're seeing spurious failures in CI here. We create a bunch of mongo instances and defer removing them from the replicaset. We destroy them immediately after removal, and then destroy the root, so the Remove is extraneous. This should improve test reliability.
cmd/jujud: avoid duplicate code for counting upgrade attempts in upgrade tests
cmd/jujud: avoid duplication in the 2 "success" upgrade test cases
cmd/jujud: shorten upgrade test helper names

Makes the tests a little more readable.
cmd/jujud: rationalise machine & config handling in upgrade tests

These tests have always been a bit confusing because machine-0 and its
config were being stored on the test suite, with various helper
methods magically using them as required. Data associated with other
machines have always been stored in local variables and passed around.

This change makes the data for machine-0 be handled consistently. This
makes for more explicit, clearer tests and has allowed for various
cleanups.
Merge branch 'master' into lp-1336843-wo-jenv-destroy-env
apiserver: fix vet warning (missing arg)
state: Fix envuser test

Fix intermittent failure by updating DateCreated check to equal 'now'
or 'after now'.
Change state.User to take a names.UserTag
api/client: RetryProvisioning takes a Tag not a string

As it says on the tin.
dependencies.tsv: update juju/testing depdendency

Updated to fix a bug that showed up in #725
removed Action trigger from worker ModeHookError

This patches a bug in the uniter which can result in ModeHookError being
cleared by a successful Action run on the impacted unit.  Actions can no
longer be run in ModeHookError.

This will be resolved after the Context refactor on worker.
Merge pull request #730 from binary132/actions-modehookerror-fix

removed Action trigger from worker ModeHookError

This patches a bug in the uniter which can result in ModeHookError being
cleared by a successful Action run on the impacted unit.  Actions can no
longer be run in ModeHookError.

This will be resolved after the Context refactor on worker.
Merge pull request #723 from howbazaar/name-tag-update

Change state.User to take a names.UserTag

There are a few other drive by changes:
 - bootstrap agent test also checks created environment
 - the logging from the apiserver permission test has some breaks in it (to visually separate the test output when it fails)
 - the user manager made me sad, we are looking at consistency of tags/names
 - adding a service no longer enforces that the user exists, however an envuser must exist (remote users will exist soon)
 - the UserTag returned from state.User instances is now explicitly a local user tag (rather than implicitly)
Merge branch 'master' into lp-1336843-wo-jenv-destroy-env
Merge pull request #682 from katco-/lp-1336843-wo-jenv-destroy-env

Bootstrapping an existing environment with no .jenv file no longer destr...

https://bugs.launchpad.net/juju-core/+bug/1336843

Tests are not yet written as there will be much overlap with another PR which is yet to land. I will not merge this without tests.
Merge pull request #715 from mjs/upgrade-sync-test-refactoring

cmd/jujud: upgrades test refactoring

A bunch of refactoring of the tests relating to machine agent upgrades.
Merge pull request #721 from waigani/fix-envuser-test

state: Fix envuser test

Fix intermittent failure by updating DateCreated check to equal 'now'
or 'after now'.
simplify, thanks axw