I have been hanging onto it for a little while, but I keep trying to get into the release early and often philosophy.
Get ItLike all merb plugins, this one is a gem. You can get it from gem
sudo gem install merb_storiesYou can get it from source
svn checkout svn://rubyforge.org/var/svn/merb-plugins/merb_stories
UsageAt it's heart merb_stories is almost just a generator, but you do need to add it as a dependency to get going with it. You can safely remove it when you deploy, but for now it needs to be there to run the stories.
Generate A StoryIn your Merb.root
ruby script/generate story my_storyThis will generate all the support files, if they're missing, and also the story, story steps etc.
If you want to organise your stories a bit more, you can put them into sub-directories.
ruby script/generate story story_group/storyYou can go as deep as you like with the directories.
Running Your StoriesIt's really simple to run your stories. merb_stories supplies a rake task to remove any pain you might have.
rake story[my_story]or if you used subdirectories
rake story[story_group/my_story]You can also just run all of them at once.
Thats really about all there is to it. To check out what to use stories for checkout the rSpec site.