Intermediate checking on barclamp create dependencies [1/1]

This pull request got tangled up with the 1.9 test breakage that I caused.

It mainly sets up the next step of creating dependencies for deployments
with cleanups and useful utilties (like snapshot.[name]_role) and
fixing the barclamp.create_propose super calls.

The pull includes an improvement to the documentation system that allows
you to order topics using number prefixes instead of the meta data.

I've also added role.name.  This small change is to prepare for the elimination
of the unneeded role_type object.


 BDD/features/deployment.feature                    |    4 +-
 BDD/features/documentation.feature                 |    2 +-
 .../app/controllers/deployment_controller.rb       |   28 -----
 .../app/controllers/deployments_controller.rb      |   13 +-
 .../app/controllers/docs_controller.rb             |    1 -
 crowbar_framework/app/models/barclamp.rb           |   15 ++-
 .../app/models/barclamp_crowbar/barclamp.rb        |   38 +++++-
 crowbar_framework/app/models/doc.rb                |    7 +-
 crowbar_framework/app/models/node.rb               |    2 +-
 crowbar_framework/app/models/snapshot.rb           |    9 ++
 .../app/views/barclamp/_index.html.haml            |    4 +-
 .../app/views/deployment/_buttons.html.haml        |    2 -
 .../app/views/deployment/_new.html.haml            |    1 -
 .../app/views/deployment/_show.html.haml           |    5 -
 .../app/views/deployment/show.html.haml            |   31 -----
 .../app/views/deployments/_buttons.html.haml       |    2 +
 .../app/views/deployments/_new.html.haml           |    1 +
 .../app/views/deployments/_show.html.haml          |    5 +
 .../app/views/deployments/show.html.haml           |   41 +++++++
 crowbar_framework/config/locales/crowbar/en.yml    |    3 +-
 crowbar_framework/config/routes.rb                 |    2 +-
 .../db/migrate/20120731225510_create_roles.rb      |    2 +
 .../test/unit/attrib_has_deployment_test.rb        |   13 +-
 crowbar_framework/test/unit/snapshot_model_test.rb |    7 ++
 doc/crowbar.yml                                    |   22 ----
 doc/devguide/documentation.md                      |    8 ++
 doc/gettingstarted/0100_configuring_network.md     |   16 +++
 doc/gettingstarted/0500_installing_admin_node.md   |   33 ++++++
 doc/gettingstarted/1000_installing_crowbar.md      |   31 +++++
 doc/gettingstarted/1500_discovering_nodes.md       |    8 ++
 doc/gettingstarted/2000_installing_openstack.md    |   48 ++++++++
 doc/gettingstarted/2500_installing_hadoop.md       |  124 ++++++++++++++++++++
 doc/gettingstarted/3000_additional_info.md         |    4 +
 doc/gettingstarted/additional_info.md              |    4 -
 doc/gettingstarted/configuring_network.md          |   16 ---
 doc/gettingstarted/discovering_nodes.md            |    8 --
 doc/gettingstarted/installing_admin_node.md        |   33 ------
 doc/gettingstarted/installing_crowbar.md           |   31 -----
 doc/gettingstarted/installing_hadoop.md            |  124 --------------------
 doc/gettingstarted/installing_openstack.md         |   48 --------
 doc/userguide/100_introduction.md                  |   37 ++++++
 doc/userguide/introduction.md                      |   37 ------
 42 files changed, 457 insertions(+), 413 deletions(-)

Crowbar-Pull-ID: a142f1694ad43c71553a6ba6cf11f6ebac75b086

Crowbar-Release: development