On Fri, Mar 21, 2008 at 9:38 AM, David Chelimsky <[EMAIL PROTECTED]> wrote: > On Fri, Mar 21, 2008 at 5:24 AM, Tim Haines <[EMAIL PROTECTED]> wrote: > > Hi there, > > > > newb q: The "pending" support for spec's and steps is nice. I'm just > > wondering why a scenario itself can't be pending? > > Because nobody asked for it :) > > Wanna file a feature request at lighthouse? http://rspec.lighthouseapp.com > > > > I.e. it seems to me like > > it would be nice to write up scenario titles for scenarios as you think of > > them, and for low-priority fringe scenarios leave the steps unwritten until > > it comes time to implement the scenario? > > > > Is there a way to add comments to the plain text file in plain text > stories? > > Anything between the line that begins with Story: and the first line > that begins with Scenario: will be part of the story narrative. Sort > of like a comment, but it gets printed out. So I sometimes add > additional commentary there to provide context around the "As a .., I > want ..., So that ..." statement. > > Anything after the first Scenario: that does not begin with any of the > keywords (Scenario:, Given, When, Then, And) is simply ignored, so you > can put comments between steps and they will not be processed. > > I would not go crazy with this at this point because there has been a > request to support multiline text in plain text stories, at which > point your comments might accidentally get interpreted. > > Perhaps now is the time to devise a formal "comment indicator." I > think the obvious choice would be the same one we use in Ruby: # > > Given this step > # this is a comment > When this other step > etc > > Thoughts? >
Rather than anything that does not start with Scenario|Given|When|Then|And being treated as a comment it seems more future-proof if we just say that any line whose first non-whitespace character is a # ... is a comment. Although I'm not crazy about inserting comments into plain text story files, I think that there are times when it would indeed be useful and I'd want to give the developer or customer the ability to make the call when they might need it. Zach -- Zach Dennis http://www.continuousthinking.com _______________________________________________ rspec-users mailing list rspec-users@rubyforge.org http://rubyforge.org/mailman/listinfo/rspec-users
