Added intro documentation for syntaxes

lib/factory_girl/syntax.rb

@@ -0,0 +1,12 @@
+class Factory
+  # Provides alternate syntaxes for factory_girl. If you don't like the default
+  # syntax for defining or using factories, look at one of the Factory::Syntax
+  # modules:
+  #
+  # * Factory::Syntax::Blueprint: definition syntax similar to Machinist
+  # * Factory::Syntax::Generate: usage syntax similar to Object Daddy
+  # * Factory::Syntax::Make: usage syntax similar to Machinist
+  # * Factory::Syntax::Sham: sequence syntax similar to Machinist
+  module Syntax
+  end
+end

lib/factory_girl/syntax/blueprint.rb

@@ -1,5 +1,5 @@
 class Factory
-  module Syntax #:nodoc:
+  module Syntax
 
     # Extends ActiveRecord::Base to provide a make class method, which is an
     # alternate syntax for defining factories.

lib/factory_girl/syntax/generate.rb

@@ -1,5 +1,5 @@
 class Factory
-  module Syntax #:nodoc:
+  module Syntax
 
     # Extends ActiveRecord::Base to provide generation methods for factories.
     #

lib/factory_girl/syntax/make.rb

@@ -1,5 +1,5 @@
 class Factory
-  module Syntax #:nodoc:
+  module Syntax
 
     # Extends ActiveRecord::Base to provide a make class method, which is a
     # shortcut for Factory.create.

lib/factory_girl/syntax/sham.rb

@@ -1,5 +1,5 @@
 class Factory
-  module Syntax #:nodoc:
+  module Syntax
 
     # Adds a Sham module, which provides an alternate interface to
     # Factory::Sequence.