[rspec-users] describe "RSpec's documentation" do

Matt Patterson matt at reprocessed.org
Thu Jan 7 09:15:12 EST 2010

On 7 Jan 2010, at 00:53, Matt Wynne wrote:

> On 5 Jan 2010, at 12:17, Matt Patterson wrote:
>> I've been looking at the documentation again recently, and I'd be happy to start work on this, particularly if Matt W is wanting to look at the cucumber end since he's just up the road from me.
>> I'm very keen on the executable documentation aspects of this, and I did a whole load of work back in 2008 on this kind of stuff using RSpec, so I've got a bit of history here :-)
> Great. I think it's time we really started dogfooding cucumber in terms of producing executable documentation. The features for Cucumber itself could do with some housekeeping, but right now the focus there is on the code, so RSpec seems like a nice place to work on this from.
> I would like to see us try to build a flat HTML website (or PDF reference book) from rspec's features directory which could be used as reference by a new or curious user. As David says, I think we could drive out a bunch of really nice features from Cucumber to help make it much easier to build and maintain large suites of features.
> So what's the first step? A pint or two at the Reliance perhaps Mr Patterson?

That sounds about right :-)


  Matt Patterson | Design & Code
  <matt at reprocessed.org> | http://www.reprocessed.org/

More information about the rspec-users mailing list