Updates Ironic Guide with deployment information

This patch updates
Ironic deployment information
Adds 3 deployment diagrams
Describes deployment process

Change-Id: Idbe973c9a5f9805fe9a186a1db77fc66c044eeaf
Document 'POST /v1/.../vendor_passthru'

http://docs.openstack.org/developer/ironic/webapi/v1.html does
not contain anything about how to use vendor passthru endpoints.
This adds 'POST /v1/nodes/(node_uuid)/vendor_passthru' and
'POST /v1/drivers/(driver_name)/vendor_passthru' to that
html page.

Change-Id: I6191be759f168c58e80d946530af7a0c4267501c
Closes-Bug: #1331415
Update docstring for api...node.validate

Add the param to the docstring for api.controllers.v1.node.validate.
With this change, the generated webapi page [1] will include this
information. Without it, it shows:
    Validate the driver interfaces. :type node_uuid: uuid

[1] http://docs.openstack.org/developer/ironic/webapi/v1.html

Change-Id: Ia33755b7ef1473aa0d04b22c76f20b7f1a99cd6b
REST API 'limit' parameter to only accept positive values

The REST API 'limit' parameter was accepting 0 as a valid value, but 0
is not a positive value.

Closes-Bug: #1340280
Change-Id: Ib816c6003da6dee740addb25eb5d4bffe2497967
Update webapi doc with link and console

http://docs.openstack.org/developer/ironic/webapi/v1.html is updated
as follows:
- changes the path descriptor of NodeStates to use '(node_uuid)' instead
  of '<uuid>' to be consistent with other paths
- adds [GET/PUT] /v1/nodes/(node_uuid)/states/console to show how to
  access the node's console
- fixes the "Links" section so that Link information is shown

Change-Id: I9d4a32550b81bb5ccf2fa23d8b591d8a945c04cc
Merge "Update docstring for api...node.validate"
Merge "REST API 'limit' parameter to only accept positive values"
Merge "Updates Ironic Guide with deployment information"
Merge "Document 'POST /v1/.../vendor_passthru'"
Merge "Update webapi doc with link and console"