README.md in csv2hash-0.0.1 vs README.md in csv2hash-0.0.2

@@ -25,42 +25,169 @@
 
     $ gem install csv2hash
 
 ## Usage
 
+#### Rules
+
 You should be declare an definition for you CSV, for each cells you should define what you expect.
 
 Example :
 
 You want first cell parsed should be string with values are 'yes' or 'no' you must fill follow rule :
 
 	{ name: 'aswering', type: 'string', values: ['yes', 'no'], position: [0,0] }
 
-All keys as default value, so you can just define this rule :
+All keys as default values, so you can just define this rule :
 
 	{ name: 'aswering', values: ['yes', 'no'], position: [0,0] }
 
 You can define message, default is 'undefined :key on :position'
 
 	{ name: 'aswering', values: ['yes', 'no'], position: [0,0], message: 'this value is not supported' }
 
+You can also define Range
+
+	{ name: 'score', values: 0..5, position: [0,0] }
+
 if you insert key on you message they will be substituted
 
 	{ ..., message: 'value of :name is not supported, please you one of :values' }
 
-produce ':
-	value of aswering is not supported, please you one of [yes, no]'
+produce :
 
+
+	value of aswering is not supported, please you one of [yes, no]
+
+##### Position
+
+Position mean [Y, X], where Y is rows, X columns
+
+#### Definition
+
+You should provide a definition, you have 2 types of definitions, mapping definition for search on x,y in your data or collection definition for rules apply for all lines in x, so you position rules should be only x value
+
+### Sample
+
+#### Mapping
+
+Consider csv data like that
+
+| Fields      | Person Informations  | Optional |
+|-------------|----------------------|----------|
+| Nickname    |        john          |    no    |
+| First Name  |        John          |    yes   |
+| Last Name   |        Doe           |    yes   |
+
+
+Mapping sample definition
+
+	class MyParser
+
+		attr_accessor :file_path
+
+		def initialize file_path
+			@file_path = file_path
+		end
+
+		def rules
+			[].tap do |mapping|
+				mapping << { position: [2,1], key: 'first_name' }
+				mapping << { position: [3,1], key: 'last_name' }
+			end
+		end
+
+		def definition
+			Definition.new(rules, type = Definition::MAPPING)
+		end
+
+		def data
+			Csv2hash.new(definition, file_path).tap do |csv2hash|
+				csv2hash.parse
+			end.data
+		end
+
+	end
+
+#### Collection
+
+Consider csv data like that
+
+| Nickname | First Name | Last Name |
+|----------|------------|-----------|
+|   john   |    John    |    Doe    |
+|   jane   |    Jane    |    Doe    |
+
+Mapping sample definition
+
+	class MyParser
+
+		attr_accessor :file_path
+
+		def initialize file_path
+			@file_path = file_path
+		end
+
+		def rules
+			[].tap do |mapping|
+				mapping << { position: 0, key: 'nickname'   }
+				mapping << { position: 1, key: 'first_name' }
+				mapping << { position: 2, key: 'last_name'  }
+			end
+		end
+
+		def definition
+			Definition.new(rules, type = Definition::COLLECTION)
+		end
+
+		def data
+			Csv2hash.new(definition, file_path).tap do |csv2hash|
+				csv2hash.parse
+			end.data
+		end
+
+	end
+
+#### Headers
+
+You should be define header size
+
+	Definition.new(rules, type, header_size=0)
+
+#### Exception or CSV mode
+
+You can choice 2 mode of parsing, either exception mode for raise exception in first breaking rules or csv mode for get csv original data + errors throwing into added columns.
+
+
+parse return data or csv_with_errors if parse is invalid, you can plug this like that :
+
+	csv2hash = Csv2hash.new(definition, 'file_path').new
+	result = csv2hash.parse
+	return result if csv2hash.valid?
+
+	filename = 'issues_errors.csv'
+	tempfile = Tempfile.new [filename, File.extname(filename)]
+	File.open(tempfile.path, 'wb') { |file| file.write result }
+
+	# Send mail with csv file + errors and free resource
+
+	tempfile.unlink
+
+
 #### Default values
 
+only position is require
+
+* :position
+
+all remaind keys are optionals
+
 * message:     'undefined :key on :position'
 * mappable:    true
 * type:        'string'
 * values:      nil
 * nested:      nil
 * allow_blank: false
-* position:    nil
-* maptype:     'cell'
 
 ### Limitations
 
 
 ## Contributing