cukesalad 0.7.0 → 0.8.0

data/Examples/Calculator/Gemfile

@@ -3,3 +3,7 @@ gem "cukesalad", ">=0.7"
 gem "rspec", ">=2.5.0", :require => 'spec'
 gem "capybara", ">=0.4.1.2"
 gem "sinatra", ">=1.2.0"
+
+group :test, :development do
+  gem 'sinatra-reloader', '0.5.0'
+end

data/Examples/Calculator/Gemfile.lock

@@ -7,38 +7,42 @@ GEM
       cucumber (>= 0.10.7)
       rdiscount (>= 1.6.8)
       rspec (>= 2.6.0)
-    bcat (0.6.1)
+    backports (2.3.0)
+    bcat (0.6.2)
       rack (~> 1.0)
     builder (3.0.0)
-    capybara (1.0.0)
+    capybara (1.1.1)
       mime-types (>= 1.16)
       nokogiri (>= 1.3.3)
       rack (>= 1.0.0)
       rack-test (>= 0.5.4)
-      selenium-webdriver (~> 0.2.0)
+      selenium-webdriver (~> 2.0)
       xpath (~> 0.1.4)
-    childprocess (0.1.9)
+    childprocess (0.2.2)
       ffi (~> 1.0.6)
-    cucumber (1.0.0)
+    cucumber (1.0.2)
       builder (>= 2.1.2)
       diff-lcs (>= 1.1.2)
-      gherkin (~> 2.4.1)
+      gherkin (~> 2.4.5)
       json (>= 1.4.6)
       term-ansicolor (>= 1.0.5)
-    cukesalad (0.7.0)
-      aruba (>= 0.3.5)
-      cucumber (>= 0.10.0)
+    cukesalad (0.8.0)
+      aruba (= 0.4.3)
+      cucumber (= 1.0.2)
       rspec (>= 2.5.0)
-    diff-lcs (1.1.2)
+    diff-lcs (1.1.3)
     ffi (1.0.9)
-    gherkin (2.4.1)
+    gherkin (2.4.18)
       json (>= 1.4.6)
-    json (1.5.3)
-    json_pure (1.5.3)
+    json (1.5.4)
+    json_pure (1.5.4)
+      spruz (~> 0.2.8)
     mime-types (1.16)
+    monkey-lib (0.5.4)
+      backports
     nokogiri (1.5.0)
-    rack (1.3.0)
-    rack-test (0.6.0)
+    rack (1.3.2)
+    rack-test (0.6.1)
       rack (>= 1.0)
     rdiscount (1.6.8)
     rspec (2.6.0)
@@ -50,16 +54,27 @@ GEM
       diff-lcs (~> 1.1.2)
     rspec-mocks (2.6.0)
     rubyzip (0.9.4)
-    selenium-webdriver (0.2.2)
-      childprocess (>= 0.1.9)
+    selenium-webdriver (2.5.0)
+      childprocess (>= 0.2.1)
       ffi (>= 1.0.7)
       json_pure
       rubyzip
     sinatra (1.2.6)
       rack (~> 1.1)
-      tilt (< 2.0, >= 1.2.2)
-    term-ansicolor (1.0.5)
-    tilt (1.3.2)
+      tilt (>= 1.2.2, < 2.0)
+    sinatra-advanced-routes (0.5.1)
+      monkey-lib (~> 0.5.0)
+      sinatra (~> 1.0)
+      sinatra-sugar (~> 0.5.0)
+    sinatra-reloader (0.5.0)
+      sinatra (~> 1.0)
+      sinatra-advanced-routes (~> 0.5.0)
+    sinatra-sugar (0.5.1)
+      monkey-lib (~> 0.5.0)
+      sinatra (~> 1.0)
+    spruz (0.2.13)
+    term-ansicolor (1.0.6)
+    tilt (1.3.3)
     xpath (0.1.4)
       nokogiri (~> 1.3)
 
@@ -71,3 +86,4 @@ DEPENDENCIES
   cukesalad (>= 0.7)
   rspec (>= 2.5.0)
   sinatra (>= 1.2.0)
+  sinatra-reloader (= 0.5.0)

data/Examples/Calculator/README.md

@@ -14,4 +14,11 @@ To run these via a web front end, use:
 
     bundle exec cucumber -p alternative
 
+To run the Calculator app
+
+    rackup lib/config.ru
+
+Then, in a browser, navigate to http://localhost:[port]
+(The port to use  will be shown in the stdout) 
+
 Enjoy!!

data/Examples/Calculator/cucumber.yml

@@ -1,4 +1,4 @@
 default: --exclude features/lib/alternative/
-alternative: -r features/lib/alternative/ -r features/support/env.rb -r features/lib/default/tasks/ 
+front_door: -r features/lib/browser/ -r features/support/env.rb -r features/lib/default/tasks/ 
 autotest: --color
 autotest-all: --color

data/Examples/Calculator/features/addition.feature

@@ -5,7 +5,7 @@ Feature: Addition
 	
 Scenario Outline: Find the sum of two numbers
   Given I am a Calculating Individual
-  When I attempt to add: the number '<first_number>' and the number '<second_number>'
+  When I add, the number '<first_number>' and the number '<second_number>'
   Then I should see the answer '<result>'
 
 	

data/Examples/Calculator/features/lib/{alternative → browser}/roles/calculating_web_user.rb

@@ -6,7 +6,7 @@ require 'capybara'
 require 'capybara/dsl'
 
 Capybara.app = WebCalculator
-Capybara.default_driver = :rack_test
+Capybara.default_driver = :selenium
 
 module CalculatingIndividual
 

data/Examples/Calculator/features/lib/default/roles/calculating_individual.rb

@@ -1,4 +1,5 @@
 require 'calculator'
+require 'calculator_operations'
 
 module CalculatingIndividual
 
@@ -8,10 +9,7 @@ module CalculatingIndividual
 
   def switch_on_the_calculator
     @calculator = Calculator.new
-    @operate_with = {
-      plus: :+,
-     minus: :-
-    }
+    @operate_with = CalculatorOperations::OPERATIONS
   end
 
   def enter value
@@ -22,7 +20,7 @@ module CalculatingIndividual
     if next_operator == :equals
       equals
     else
-      @calculator.get_ready_to @operate_with[next_operator]
+      @calculator.get_ready_to @operate_with[next_operator.to_s]
     end
   end
 

data/Examples/Calculator/features/lib/default/tasks/reference/calculations.rb

@@ -1,3 +1,5 @@
+require 'calculator_operations'
+
 module Calculations
   
   def follow_the_steps_for sum
@@ -5,10 +7,10 @@ module Calculations
   end
   
   def enter_numbers_and_operators_for sum
-    operator = {"+" => :plus, "-" => :minus, "=" => :equals}
+    operators = CalculatorOperations::OPERATORS
     sum.each do | token |
       enter token.to_i if token =~ /\d+/
-      press operator[token] if operator.include? token
+      press operators[token] if operators.include? token
     end
   end
 end

data/Examples/Calculator/features/subtraction.feature

@@ -5,7 +5,7 @@ Feature: Subtraction
 	
 Scenario Outline: Find the result of subtracting two numbers
   Given I am a Calculating Individual
-  When I attempt to subtract, the number '<subtractor>' from the number '<subtractee>'
+  When I subtract, the number '<subtractor>' from the number '<subtractee>'
   Then I should see the answer '<result>'
 
 	

data/Examples/Calculator/lib/calculator_operations.rb

@@ -0,0 +1,4 @@
+module CalculatorOperations
+  OPERATORS = { '+' => :plus, '-' => :minus, '=' => :equals }
+  OPERATIONS = { 'plus' => :+, 'minus' => :-, 'equals' => '=' }
+end

data/Examples/Calculator/lib/web_calculator.rb

@@ -1,16 +1,25 @@
 require 'sinatra/base'
 require 'erb'
+
 $:.unshift(File.dirname(__FILE__), '.')
 require 'calculator'
-
-Sinatra::Base.enable :inline_templates
-Sinatra::Base.enable :sessions
+require 'calculator_operations'
 
 class WebCalculator < Sinatra::Base
 
+  use Rack::Session::Pool
+
+  configure :development, :test do
+      require 'sinatra/reloader'
+  end
+
   helpers do
-    def operate_with
-      { 'plus' => :+, 'minus' => :-}
+    def available_operations
+      CalculatorOperations::OPERATIONS
+    end
+
+    def operate_with operator
+      available_operations[operator]
     end
 
     def persist calc
@@ -19,6 +28,7 @@ class WebCalculator < Sinatra::Base
 
     def display_result_from calc
       @display = calc.display
+      @operations = available_operations
       erb :index
     end
 
@@ -32,6 +42,7 @@ class WebCalculator < Sinatra::Base
 
     def display_result_from_session
       @display = session[:calc].display ||= 0
+      @operations = available_operations
       erb :index
     end
 
@@ -60,23 +71,9 @@ class WebCalculator < Sinatra::Base
     if equals_pressed?
       calculator.equals
     else
-      calculator.get_ready_to operate_with[selected_operator]
+      calculator.get_ready_to operate_with(selected_operator)
     end
     persist calculator
     display_result_from calculator
   end
 end
-
-__END__
-@@ layout
-<h1>Calculator is Ready!</h1>
-<%= yield %>
-
-@@ index
-<form method="POST" action="/">
-  <input type="text" disabled name="display" id="display" value="<%=@display %>" />
-  <input type="text" name="number" id="number" />
-  <input type="submit" name="operator" id="minus" text="-" value="minus" />
-  <input type="submit" name="operator" id="plus" text="+" value="plus" />
-  <input type="submit" name="operator" id="equals" text="=" value="equals" />
-</form>

data/Examples/Calculator/views/index.erb

@@ -0,0 +1,7 @@
+<form method="POST" action="/">
+  <input type="text" disabled name="display" id="display" value="<%=@display %>" /><br/>
+  <input type="text" name="number" id="number" /><br/>
+  <% @operations.each do |key, value| %>
+    <input type="submit" name="operator" id="<%=key%>" text="<%=value%>" value="<%=key%>" />
+  <% end %>
+</form>

data/Examples/Calculator/views/layout.erb

@@ -0,0 +1,2 @@
+<h1>Calculator is Ready!</h1>
+<%= yield %>

data/Gemfile.lock

@@ -1,9 +1,9 @@
 PATH
   remote: .
   specs:
-    cukesalad (0.7.0)
-      aruba (>= 0.3.5)
-      cucumber (>= 0.10.0)
+    cukesalad (0.8.0)
+      aruba (= 0.4.3)
+      cucumber (= 1.0.2)
       rspec (>= 2.5.0)
 
 GEM
@@ -16,28 +16,28 @@ GEM
       cucumber (>= 0.10.7)
       rdiscount (>= 1.6.8)
       rspec (>= 2.6.0)
-    bcat (0.6.1)
+    bcat (0.6.2)
       rack (~> 1.0)
     builder (3.0.0)
-    childprocess (0.1.9)
+    childprocess (0.2.2)
       ffi (~> 1.0.6)
-    cucumber (1.0.0)
+    cucumber (1.0.2)
       builder (>= 2.1.2)
       diff-lcs (>= 1.1.2)
-      gherkin (~> 2.4.1)
+      gherkin (~> 2.4.5)
       json (>= 1.4.6)
       term-ansicolor (>= 1.0.5)
-    diff-lcs (1.1.2)
+    diff-lcs (1.1.3)
     ffi (1.0.9)
     ffi (1.0.9-java)
-    gherkin (2.4.1)
+    gherkin (2.4.18)
       json (>= 1.4.6)
-    gherkin (2.4.1-java)
+    gherkin (2.4.18-java)
       json (>= 1.4.6)
     json (1.4.6)
     json (1.4.6-java)
     mime-types (1.16)
-    rack (1.3.0)
+    rack (1.3.2)
     rake (0.8.7)
     rdiscount (1.6.8)
     relish (0.3.0)
@@ -54,7 +54,7 @@ GEM
     rspec-expectations (2.6.0)
       diff-lcs (~> 1.1.2)
     rspec-mocks (2.6.0)
-    term-ansicolor (1.0.5)
+    term-ansicolor (1.0.6)
 
 PLATFORMS
   java

data/VERSION

@@ -1 +1 @@
-0.7.0
+0.8.0

data/cukesalad.gemspec

@@ -25,9 +25,9 @@ Gem::Specification.new do |s|
   s.default_executable = "cukesalad"
   s.require_paths      = ["lib"]
 
-  s.add_runtime_dependency "cucumber", ">=0.10.0"
+  s.add_runtime_dependency "cucumber", "1.0.2" # Version 1.0.4 experiences following error: 'Illformed requirement ["#<Syck::DefaultKey:0x000001034764a0> 0.8.4"]'
   s.add_runtime_dependency "rspec",    ">=2.5.0"
-  s.add_runtime_dependency "aruba",    ">=0.3.5"
+  s.add_runtime_dependency "aruba",    "0.4.3"
 
   s.add_development_dependency "bundler", "~> 1.0.0"
   s.add_development_dependency "rake", "~> 0.8.7"

data/features/README.markdown

@@ -1,299 +1,65 @@
-# Cuke Salad
+![RiverGlide logo](http://riverglide-live.heroku.com/attachments/branding/riverglide_logo_medium.png)
 
-_Cucumber, washed and ready to eat for Friction-free ATDD/BDD_
+# cukesalad - a cucumber extension
 
-**This is a work in progress - feedback welcome**
-e-mail feedback to <talktous@riverglide.com>
+_Cucumber, washed and ready to eat for friction-free ATDD/BDD_
 
-You can see our current list of intended features under issues:
-[https://github.com/RiverGlide/CukeSalad/issues?labels=Feature](https://github.com/RiverGlide/CukeSalad/issues?labels=Feature)
+Cukesalad is an extension to cucumber that allows you to write scenarios without regular expression.
+It encourages you to separte your code in neat, organised and focused parts.
+With cukesalad you focus on expressing your intent not on regular expressions.
 
+You can combine cukesalad with your regular step definitions.
 
-## This project has step-free access!
+* [Get the Gem](https://rubygems.org/gems/cukesalad)
+* [Find it on Github](http://github.com/RiverGlide/CukeSalad)
 
-CukeSalad allows you to focus on the task at hand - expressing examples, the roles involved in those examples and what those roles can do with the product under development.
+## Synopsis
+<iframe width="560" height="349" src="http://www.youtube.com/embed/UYN7p_7IlZ8" frameborder="0" allowfullscreen></iframe>
 
-With CukeSalad you don't need to write step-definitions.
+There are no step-definitions required for this to work:
 
-Of course, you still have to write some code - but only the code that expresses:
+    When I attempt to add, the number '1' to the number '2'
 
-* the roles and the actions they can perform
-* the tasks and the actions involved in completing that task
-
-## Goals->Tasks->Actions
-The terms *"actions"* and *"tasks"* above come from Task Analysis, as used in User Centred Design (UCD) of Human Computer Interfaces (HCI) a.k.a. User Experience (UX):
-
-* *Goal:* What we’re trying to achieve which has one or more…
-* *Tasks:* The high-level work-item that we complete to fulfil the goal, each having one or more…
-* *Actions:* The specific steps or interactions we execute to complete the task.
-
-More information about Goals, Tasks and Actions can be found in this [blog post](http://antonymarcano.com/blog/2011/03/goals-tasks-action/)
-
-Let's see how this works with a simple example...
-
-## Install
-
-    gem install cukesalad
-
-## Let's Get started
-
-Create a new project called Calculator:
-
-    cukesalad Calculator
-
-Or, if you have an existing cucumber project that you want to configure to use cukesalad, you can type:
-
-    cukesalad
-
-## Write Features
-
-In `features/`, let's create our first feature file - `a_place_to_start.feature`:
-
-    Feature: A Place To Start
-    As Callie, a calculating individual
-    I want to know when my calculator is on
-    So that I know when I can start calculating
-
-    Scenario: Let's Begin
-      Given I am a Calculating Individual
-      When  I attempt to switch on the calculator
-      Then  I should see the answer '0'
-
-Let's take a moment to understand this scenario:
-
-    Scenario: Let's Begin
-      Given I am a <some role>
-      When  I attempt to <do some task>
-      Then  I should <ask some question> '<expected answer>'
-
-To get this working, we don't need to write any steps. Instead, we describe tasks...
-
-## Create Tasks
-
-Explaining how to do a _task_ is easy:
-Create a new file, `features/lib/tasks/switch_on_the_calculator.rb`
-
-Remember the step `When  I attempt to switch on the calculator`
-
-    in_order_to "switch on the calculator" do
-      switch_on_the_calculator
-    end
-
-Remember the step `Then  I should see the answer '0'`
-Now we need `task/see_the_answer.rb`
-
-    in_order_to "see the answer" do
-      look_at_the_display
-    end
-
-Now we've explained the _tasks_, we need to define the _role_ that performs them. In
-this example, we need to explain how the `CalculatingIndividual` _role_ works...
-
-## Create Roles
-
-Remember the step `Given I am a Calculating Individual`?
-
-We explain a _role_ by creating a new file
-called `features/lib/roles/calculating_individual.rb`
-
-    module CalculatingIndividual
-
-      def switch_on_the_calculator
-        @calculator = Calculator.new
-      end
-
-      def look_at_the_display
-        @calculator.display
-      end
-    end
-
-You'll need a class called Calculator on the load path of course, but that's it.
-
-From your project folder, run (_note: '%' is our command prompt_)
-
-    % cucumber
-
-We now have our first passing Feature, without creating a single step definition!
-
-## Wash, rinse, repeat
-
-Let's try another scenario...
-
-    Scenario Outline: Find the sum of two numbers
-      Given I am a Calculating Individual
-      And I was able to switch on the calculator
-      When I attempt to add: the number '10' and the number '10'
-      Then I should see the answer '20'
-
-Notice that we've reused 'switch on the calculator'.
-
-The new _When_ step has a slightly different layout.
-Let's examine that for a second... See below. Notice the ':' (colon) after `<do something>` followed by the name-value pairs:
-
-    When I attempt to <do something>: <name> '<value>' <name> '<value>'
-
-You can also use a ',' (comma) in situations where a colon wouldn't quite work:
-
-    When I attempt to <do something>, <name> '<value>' <name> '<value>'
-
-`<do something>` can be as many words as you like. You can have as many name-value pairs as you like.
-
-For this to work we need a task called `tasks/add.rb` that explains the individual actions required to complete the task:
-
-    in_order_to "add" do
-      enter @value_of(:the_number)
-      press :plus
-      enter @value_of(:and_the_number)
-      press :equals
-    end
-
-Notice how the `value_of` lines use symbols that correspond to the wording `'the number '10' to the number '10'` in the "When" step.
-
-There is some 'syntactic sugar' that we can use to dress this up a little and make it read nicer... a simple attribute mapping (using Ruby 1.9.x syntax):
-
-    in_order_to "add", the_number: :first_number, to_the_number: :second_number do
-        enter the :first_number
+Instead, you write a **Task**:
+                                      
+    in_order_to 'add', the_number: :first_number, and_the_number: :second_number do
+        enter the :first_number 
         press :plus
-        enter the :second_number
+        enter the :second_number 
         press :equals
     end
 
-All we've done is mapped `:the_number` to `:first_number` and `:to_the_number` to `:second_number`. There is a special method called "the" that allows you to reference the mapped values rather than the symbols derived from the scenario.
-
-Now all we need to do is create the corresponding methods in `calculating_individual.rb`.
-
-    module CalculatingIndividual
-
-      def switch_on_the_calculator
-        @calculator = Calculator.new
-        @operate_with = {
-          plus: :+,
-         minus: :-
-        }
-      end
-
-      def enter value
-        @calculator.enter value.to_i
-      end
-
-      def press next_operator
-        if next_operator == :equals
-          equals
-        else
-          @calculator.get_ready_to @operate_with[next_operator]
-        end
-      end
-
-      def equals
-        @calculator.equals
-      end
-
-      def look_at_the_display
-        @calculator.display
-      end
-    end
-
-Of course you'll have to [implement the calculator too](https://github.com/RiverGlide/CukeSalad/blob/master/Examples/Calculator/lib/calculator.rb)
-
-Now, you can run cucumber again:
-
-    % cucumber
-
-There's no need to write `step_definitions`...
-Simply express the _roles_ and the _tasks_ in clear,
-concise, easy to read classes.
-
-If we want to know what things we can say, instead of trawling through a step-def ruby file, we can look in our tasks folder:
+Each of the above methods `enter` and `press` must be implemented in a role.
 
-    features/lib/default/tasks/
-    ├── add.rb
-    ├── calculate.rb
-    ├── calculations.rb
-    ├── see_the_answer.rb
-    ├── subtract.rb
-    └── switch_on_the_calculator.rb
+Among these examples you will find a simple tutorial and a variety examples of using cukesalad.
 
-You can structure your tasks as you see fit. For example, as the project grows, it might end up looking like this:
+_Cukesalad uses cukesalad to express all of its own examples._
 
-    features/lib/default/tasks/
-    ├── all_purpose
-    |   └── calculate.rb
-    ├── arithmetic
-    |   ├── add.rb
-    |   ├── divide.rb
-    |   ├── multiply.rb
-    |   └── subtract.rb
-    ├── extras
-    |   ├── recall_from_memory.rb
-    |   ├── store_in_memory.rb
-    |   └── switch_on_the_calculator.rb
-    ├── questions
-    |   ├── see_the_answer.rb
-    |   ├── see_the_following_indicators.rb
-    |   └── switch_on_the_calculator.rb
-    ├── trigonometry
-    |   ├── sine.rb
-    |   ├── cosine.rb
-    |   └── tangent.rb
-    └── reference_material
-        └── calculations.rb
+## Why use cukesalad?
 
-## Alternative Roles
+CukeSalad allows you to _focus on the task at hand_ - expressing examples, the roles involved in those examples and what those roles can do with the product under development.
 
-As our features _describe the value of a calculator application and not its
-implementation_, we have the opportunity to reuse them.
+cukesalad encourages you to write only the code that expresses:
 
-In the Calculator example, we create a new _role_ in
-`./features/lib/alternative/roles/calculating_web_user.rb`, which we can swap
-into our tests using a Cucumber profile defined in `features/cucumber.yml`:
-
-    default --exclude features/lib/alternative/
-    alternative -r features/lib/alternative/ -r features/support/env.rb -r features/lib/default/tasks/
-
-We can run our alternative configuration like so:
+* the roles and the actions they can perform
+* the tasks and the actions involved in completing that task
 
-  `%cucumber --profile alternative`
+cukesalad helps you focus on expressions of intent rather than regular expressions.
 
-The Calculating Web User masquerades as the Calculating Individual from our
-previous example, and provides the same API, allowing us to reuse all of our
-existing features and _tasks_.
+[More about why you would use cuke salad on the project wiki](https://github.com/RiverGlide/CukeSalad/wiki/Who-is-this-for)
 
-The alternative, `./lib/web_calculator.rb`, implementation is a simple [Sinatra](http://www.sinatrarb.com) application,
-which we drive with the [Capybara](http://github.com/jnicklas/capybara) web testing framework.
+## Goals->Tasks->Actions
+The terms *"actions"* and *"tasks"* above come from Task Analysis, as used in User Centred Design (UCD) of Human Computer Interfaces (HCI) a.k.a. User Experience (UX):
 
-By writing a single new _role_ class we're able to reuse all of our existing features,
-_tasks_ and even the `Calculator` itself, which the web calculator delegates to in order to do its calculations.
+* *Goal:* What we’re trying to achieve which has one or more…
+* *Tasks:* The high-level work-item that we complete to fulfil the goal, each having one or more…
+* *Actions:* The specific steps or interactions we execute to complete the task.
 
-After adding some more scenarios and tasks and an alternative "Calculating Individual" (see below for why), our Calculator directory structure currently looks like this...
+More information about Goals, Tasks and Actions can be found in this [blog post](http://antonymarcano.com/blog/2011/03/goals-tasks-action/)
 
-    ├── cucumber.yml
-    ├── features
-    │   ├── A_PlaceToStart.feature
-    │   ├── Addition.feature
-    │   ├── Complex_calculations.feature
-    │   ├── Subtraction.feature
-    │   ├── Typical_workflow.feature
-    │   ├── lib
-    │   │   ├── alternative
-    │   │   │   ├── roles
-    │   │   │   │   └── calculating_web_user.rb
-    │   │   │   └── tasks
-    │   │   └── default
-    │   │       ├── roles
-    │   │       │   └── calculating_individual.rb
-    │   │       └── tasks
-    │   │           ├── add.rb
-    │   │           ├── perform.rb
-    │   │           ├── see_the_answer.rb
-    │   │           ├── subtract.rb
-    │   │           └── switch_on_the_calculator.rb
-    │   └── support
-    │       └── env.rb
-    ├── lib
-    │   ├── calculator.rb
-    │   └── web_calculator.rb
-    └── spec
-        ├── calculator_spec.rb
-        └── web_calculator_spec.rb
+## Feedback
+This project is 'always in beta' - feedback welcome
 
-Take a look around the examples and the code to see how it all works. We hope you enjoy reading as much as we enjoyed writing it.
+* You can send us a [pull request](https://github.com/RiverGlide/CukeSalad/).
+* Or, log a [feature request](https://github.com/RiverGlide/CukeSalad/issues?labels=Feature)
+* Or e-mail feedback to <talktous@riverglide.com>