From f013335826bab7486ce8174958a797e27cd956de Mon Sep 17 00:00:00 2001
From: Kristian Mandrup <kmandrup@gmail.com>
Date: Sun, 1 Apr 2012 14:28:13 +0200
Subject: [PATCH] updated Getting Started with docu on new aliased sequence
 functionality

---
 GETTING_STARTED.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/GETTING_STARTED.md b/GETTING_STARTED.md
index 55f8844..d33d7bb 100644
--- a/GETTING_STARTED.md
+++ b/GETTING_STARTED.md
@@ -401,6 +401,35 @@ factory :post do
 end
 ```
 
+Sequences can also have aliases. The sequence aliases share the same counter:
+
+```ruby
+factory :user do
+  sequence(:email, 1000, :aliases => [:sender, :receiver]) {|n| "person#{n}@example.com" }
+end
+
+# will increase value counter for :email which is shared by :sender and :receiver
+FactoryGirl.next(:sender) 
+```
+
+Define aliases and use default value (=1) for the counter
+
+```ruby
+factory :user do
+  sequence(:email, :aliases => [:sender, :receiver]) {|n| "person#{n}@example.com" }
+end
+```
+
+Setting the value using the :value option:
+
+```ruby
+factory :user do
+  sequence(:email, :value => 'b', :aliases => [:sender, :receiver]) {|n| "person#{n}@example.com" }
+end
+```
+
+The value just needs to support the `#next` method. Here the next value will be 'b'.
+
 Traits
 ------