Update doc to use new sources and paths (small BDD updates) [1/1]

This pull updates the docs system to use the new
framework directory (crowbar repo) and the new barclamp doc
locations.

The move exposed bug that was overlooking some documents.

I suspect there are still some issues to resolve as we put
real inforamation into the documents.

I also ran through the BDD system and tried to make sure all the tests
were passing.  I'm also trying to redirect away from depricated code.

As part of this effort, I created a example of a step that uses the
Scenario Store/Retrieve funtion (in documentation.feature) for 
an optimization that allows the doc feature to skip regenerating the
doc index on each scenario.  This should improve performance of the
BDD test pass overall.

I also realized that the logic for "Unless..." was incorrect.  I've
added a "While..." statement that correctly allows you to target
tests for a specific environment (e.g.: interactive or devtool).  
The Unless will now work correctly by allowing you to exclude an 
environment where you know the tests will fail.


 BDD/barclamp.erl                                   |    2 +-
 BDD/bdd.erl                                        |   33 +-
 BDD/bdd_catchall.erl                               |    4 +-
 BDD/bdd_print.erl                                  |    4 +-
 BDD/bdd_utils.erl                                  |    2 +-
 BDD/bdd_webrat.erl                                 |   50 +-
 BDD/eurl.erl                                       |   13 +-
 BDD/features/documentation.feature                 |   27 +-
 BDD/features/scaffolds.feature                     |   11 -
 BDD/features/users.feature                         |   20 +-
 BDD/jig.erl                                        |    8 +-
 BDD/users.erl                                      |    8 +-
 .../app/controllers/application_controller.rb      |    2 +-
 .../app/controllers/docs_controller.rb             |   13 +-
 crowbar_framework/app/models/barclamp.rb           |    2 +-
 crowbar_framework/app/models/doc.rb                |   69 +-
 .../app/views/layouts/application.html.haml        |    3 +-
 crowbar_framework/config/locales/crowbar/en.yml    |   14 +-
 crowbar_framework/lib/api_helper.rb                |    4 +-
 doc/barclamps.md                                   |   20 -
 doc/crowbar.yml                                    |   60 +-
 doc/deployguide.md                                 |   21 -
 doc/deployguide/introduction.md                    |  766 --------------------
 doc/devguide.md                                    |  130 ----
 doc/devguide/api/attrib.md                         |  128 ++++
 doc/devguide/api/barclamp.md                       |   44 ++
 doc/devguide/api/cmdb.md                           |  130 ++++
 doc/devguide/api/group.md                          |  187 +++++
 doc/devguide/api/node.md                           |  144 ++++
 doc/devguide/api/proposal.md                       |   29 +
 doc/devguide/api/status.md                         |   42 ++
 doc/devguide/testing/bdd/dsl.md                    |   57 ++
 doc/devguide/testing/bdd/internals.md              |   53 ++
 doc/devguide/testing/bdd/internals/config.md       |   68 ++
 doc/devguide/testing/bdd/internals/json.md         |   32 +
 doc/devguide/testing/bdd/steps.md                  |  163 +++++
 doc/devguide/testing/bdd/steps_rest.md             |  145 ++++
 doc/devguide/ui/documentation.md                   |  101 +++
 doc/devguide/ui/localization.md                    |   21 +
 doc/devguide/ui/navigation.md                      |   35 +
 doc/devguide/ui/tips_and_tricks.md                 |   20 +
 doc/gettingstarted.md                              |   34 -
 doc/gettingstarted/beforeyoubegin.md               |    9 -
 doc/gettingstarted/firststeps.md                   |    7 -
 doc/gettingstarted/nextsteps.md                    |    3 -
 doc/gettingstarted/running.md                      |    5 -
 doc/licenses.md                                    |   15 -
 doc/releasenotes.md                                |   62 --
 doc/releasenotes/version1x.md                      |   21 -
 doc/releasenotes/version20.md                      |    3 -
 doc/userguide.md                                   |   25 -
 51 files changed, 1559 insertions(+), 1310 deletions(-)

Crowbar-Pull-ID: e1f67e97676aa98754e159485c9d24e22bc9901e

Crowbar-Release: development