dellcloudedge/barclamp-crowbar — pull request #65 by cloudedge (2012-05-27 18:50:06+00:00)
Title: Redesign doc system to use common markdown libraries and remove meta data from mardown files [1/5]

This refactoring was needed to eliminate pandoc in favor of
libraries that are more RPM and DEB friendly. Unfortunately,
this means that we also eliminated the meta info from the markdown.

To eliminate the markdown, I had to introduce a documentation
catalog concept (doc/[barclamp.yml]) file to organize all the
markdown files.

I think this makes is MUCH easier to organize and track the
connections between markdown because you do not have to reopen
documents just to change the layout structure.

chef/cookbooks/crowbar/recipes/default.rb | 4 +-
crowbar.yml | 5 +-
.../app/controllers/docs_controller.rb | 191 +++++++++++---------
crowbar_framework/app/views/docs/_index.html.haml | 13 +-
crowbar_framework/app/views/docs/index.html.haml | 27 ++--
crowbar_framework/app/views/docs/topic.html.haml | 30 +--
crowbar_framework/doc/crowbar.yml | 46 +++++
.../doc/default/crowbar/book-barclamps.md | 12 --
.../doc/default/crowbar/book-deployguide.md | 11 --
.../doc/default/crowbar/book-gettingstarted.md | 13 ++
.../doc/default/crowbar/book-licenses.md | 11 --
.../doc/default/crowbar/book-userguide.md | 13 --
.../doc/default/crowbar/ui-general.md | 12 --
crowbar_framework/doc/default/crowbar/ui-nodes.md | 12 --
.../doc/default/crowbar/ui-utilities.md | 12 --
.../doc/default/crowbar/utils-export.md | 12 --
16 files changed, 204 insertions(+), 220 deletions(-)