Add missing docs and make them similar

Author: vbrazo

doc/books/dune.md

@@ -11,9 +11,11 @@ Faker::Books::Dune.planet #=> "Caladan"
 
 Faker::Books::Dune.quote #=> "A dead man, surely, no longer requires that water."
 
+# Keyword arguments: character
 Faker::Books::Dune.quote(character: "baron_harkonnen") #=> "He who controls the spice, controls the universe!"
 
 Faker::Books::Dune.saying #=> "You do not beg the sun for mercy."
 
+# Keyword arguments: source
 Faker::Books::Dune.saying(source: "fremen") #=> "May thy knife chip and shatter."
 ```

doc/books/lovecraft.md

@@ -12,30 +12,30 @@ Faker::Books::Lovecraft.location #=> "Kingsport"
 
 Faker::Books::Lovecraft.word #=> "furtive"
 
-# Keyword arguments: word_count: 4, random_words_to_add: 6
+# Keyword arguments: word_count, random_words_to_add
 Faker::Books::Lovecraft.sentence #=> "Furtive antiquarian squamous dank cat loathsome amorphous lurk."
 Faker::Books::Lovecraft.sentence(word_count: 3) #=> "Daemoniac antediluvian fainted squamous comprehension gambrel nameless singular."
 Faker::Books::Lovecraft.sentence(word_count: 3, random_words_to_add: 1) #=> "Amorphous indescribable tenebrous."
 
-# Keyword arguments: number: 3, spaces_allowed: false
+# Keyword arguments: number, spaces_allowed
 Faker::Books::Lovecraft.words #=> ["manuscript", "abnormal", "singular"]
 Faker::Books::Lovecraft.words(number: 2) #=> ["daemoniac", "cat"]
 Faker::Books::Lovecraft.words(number: 2, spaces_allowed: true) #=> ["lurk", "charnel"]
 
-# Keyword arguments: number: 3
+# Keyword arguments: number
 Faker::Books::Lovecraft.sentences #=> ["Nameless loathsome decadent gambrel.", "Ululate swarthy immemorial cat madness gibbous unmentionable unnamable.", "Decadent antediluvian non-euclidean tentacles amorphous tenebrous."]
 Faker::Books::Lovecraft.sentences(number: 2) #=> ["Antediluvian amorphous unmentionable singular accursed squamous immemorial.", "Gambrel daemoniac gibbous stygian shunned ululate iridescence abnormal."]
 
-# Keyword arguments: sentence_count: 3, random_sentences_to_add: 3
+# Keyword arguments: sentence_count, random_sentences_to_add
 Faker::Books::Lovecraft.paragraph #=> "Squamous nameless daemoniac fungus ululate. Cyclopean stygian decadent loathsome manuscript tenebrous. Foetid abnormal stench. Dank non-euclidean comprehension eldritch. Charnel singular shunned lurk effulgence fungus."
 Faker::Books::Lovecraft.paragraph(sentence_count: 2) #=> "Decadent lurk tenebrous loathsome furtive spectral amorphous gibbous. Gambrel eldritch daemoniac cat madness comprehension stygian effulgence."
 Faker::Books::Lovecraft.paragraph(sentence_count: 2, random_sentences_to_add: 1) #=> "Stench cyclopean fainted antiquarian nameless. Antiquarian ululate tenebrous non-euclidean effulgence."
 
-# Keyword arguments: number: 3
+# Keyword arguments: number
 Faker::Books::Lovecraft.paragraphs #=> ["Noisome daemoniac gibbous abnormal antediluvian. Unutterable fungus accursed stench noisome lurk madness indescribable. Antiquarian fungus gibbering lurk dank fainted. Hideous loathsome manuscript daemoniac lurk charnel foetid.", "Non-euclidean immemorial indescribable accursed furtive. Dank unnamable cyclopean tenebrous stench immemorial. Eldritch abnormal gibbering tenebrous. Singular accursed lurk.", "Charnel antediluvian unnamable cat blasphemous comprehension tenebrous. Nameless accursed amorphous unnamable stench. Squamous unnamable mortal accursed manuscript spectral gambrel amorphous. Shunned stygian charnel unutterable. Tenebrous ululate lurk amorphous unnamable."]
 Faker::Books::Lovecraft.paragraphs(number: 2) #=> ["Hideous amorphous manuscript antediluvian non-euclidean cat eldritch foetid. Stench squamous manuscript amorphous gibbering fainted gibbous. Accursed loathsome blasphemous iridescence antediluvian abnormal ululate manuscript. Singular manuscript gibbering decadent accursed indescribable.", "Tenebrous unnamable comprehension antediluvian lurk. Lurk spectral noisome gibbering. Furtive manuscript madness tenebrous daemoniac."]
 
-# Keyword arguments: characters: 3, supplemental: false
+# Keyword arguments: characters, supplemental
 Faker::Books::Lovecraft.paragraph_by_chars #=> "Truffaut stumptown trust fund 8-bit messenger bag portland. Meh kombucha selvage swag biodiesel. Lomo kinfolk jean shorts asymmetrical diy. Wayfarers portland twee stumptown. Wes anderson biodiesel retro 90's pabst. Diy echo 90's mixtape semiotics. Cornho."
 Faker::Books::Lovecraft.paragraph_by_chars(characters: 256) #=> "Hella kogi blog narwhal sartorial selfies mustache schlitz. Bespoke normcore kitsch cred hella fixie. Park aesthetic fixie migas twee. Cliche mustache brunch tumblr fixie godard. Drinking pop-up synth hoodie dreamcatcher typewriter. Kitsch biodiesel green."
 ```

doc/default/alphanumeric.md

@@ -1,7 +1,9 @@
 # Faker::Alphanumeric
 
 ```ruby
+# Keyword arguments: characters
 Faker::Alphanumeric.alpha(characters: 10) #=> "zlvubkrwga"
 
+# Keyword arguments: characters
 Faker::Alphanumeric.alphanumeric(characters: 10) #=> "3yfq2phxtb"
 ```

doc/default/bank.md

@@ -3,11 +3,12 @@
 
 Faker::Bank.account_number #=> 6738582379
 
+# Keyword arguments: digits
 Faker::Bank.account_number(digits: 13) #=> 673858237902
 
 Faker::Bank.iban #=> "GB76DZJM33188515981979"
 
-# Keyword argument: country_code
+# Keyword arguments: country_code
 # All countries should be supported
 Faker::Bank.iban(country_code: "be") #=> "BE6375388567752043"
 

doc/default/boolean.md

@@ -5,6 +5,6 @@ Available since version 1.6.2.
 ```ruby
 Faker::Boolean.boolean #=> true
 
-# Keyword parameter: true_ratio: 0.5
+# Keyword parameter: true_ratio
 Faker::Boolean.boolean(true_ratio: 0.2) #=> false
 ```

doc/default/chile_rut.md

@@ -7,6 +7,7 @@ Faker::ChileRut.full_rut #=> "30686957-4"
 Faker::ChileRut.rut #=> 11235813
 
 # Returns rut between passed minimum rut and 99999999
+# Keyword arguments: min_rut
 Faker::ChileRut.rut(min_rut: 20_890_156) #=> 31853211
 
 # Every call to rut or full_rut generates a new random rut, so last_rut and dv

doc/default/code.md

@@ -11,6 +11,7 @@ Faker::Code.rut #=> "91389184-8"
 
 Faker::Code.nric #=> "S5589083H"
 
+# Keyword arguments: min_age, max_age
 Faker::Code.nric(min_age: 27, max_age: 34) #=> S8505970Z
 
 Faker::Code.imei #= "546327785982623"

doc/default/commerce.md

@@ -3,7 +3,7 @@
 ```ruby
 Faker::Commerce.color #=> "lavender"
 
-# Keyword arguments max: 3, fixed_amount: false
+# Keyword arguments: max, fixed_amount
 Faker::Commerce.department #=> "Grocery, Health & Beauty"
 Faker::Commerce.department(max: 5) #=> "Grocery, Books, Health & Beauty"
 Faker::Commerce.department(max: 2, fixed_amount: true) #=> "Books & Tools"
@@ -13,11 +13,12 @@ Faker::Commerce.material #=> "Steel"
 Faker::Commerce.product_name #=> "Practical Granite Shirt"
 
 # Produces a Float by default
+# Keyword arguments: range, as_string
 Faker::Commerce.price #=> 44.6
 Faker::Commerce.price(range: 0..10.0, as_string: true) #=> "2.18"
 
 # Generate a random promotion code.
-# Keyword argument digits: 6 for number of random digits in suffix
+# Keyword arguments: digits
 Faker::Commerce.promotion_code #=> "AmazingDeal829102"
 Faker::Commerce.promotion_code(digits: 2) #=> "AmazingPrice57"
 

doc/default/company.md

@@ -70,6 +70,7 @@ Faker::Company.south_african_trust_registration_number #=> "IT38/6489900"
 Faker::Company.brazilian_company_number #=> "18553414000618"
 
 # Get a random formatted Brazilian company number (CNPJ)
+# Keyword arguments: formatted
 Faker::Company.brazilian_company_number(formatted: true) #=> "00.000.000/0000-00"
 
 # Get a random USA Standard Industrial Classification code (SIC)

doc/default/date.md

@@ -2,17 +2,22 @@
 
 ```ruby
 # Random date between dates
+# Keyword arguments: from, to
 Faker::Date.between(from: 2.days.ago, to: Date.today) #=> "Wed, 24 Sep 2014"
 
 # Random date between dates except for certain date
+# Keyword arguments: from, to, excepted
 Faker::Date.between_except(from: 1.year.ago, to: 1.year.from_now, excepted: Date.today) #=> "Wed, 24 Sep 2014"
 
 # Random date in the future (up to maximum of N days)
+# Keyword arguments: days
 Faker::Date.forward(days: 23) # => "Fri, 03 Oct 2014"
 
 # Random date in the past (up to maximum of N days)
+# Keyword arguments: days
 Faker::Date.backward(days: 14) #=> "Fri, 19 Sep 2014"
 
 # Random birthday date (maximum age between 18 and 65)
+# Keyword arguments: min_age, max_age
 Faker::Date.birthday(min_age: 18, max_age: 65) #=> "Mar, 28 Mar 1986"
 ```