From bc2ec7cda230db3a42927a3a28f13eed04137698 Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 17:45:30 -0600
Subject: [PATCH 01/31] Add YARD docs for Faker::Music::UmphreysMcgee

---
 lib/faker/music/umphreys_mcgee.rb | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/lib/faker/music/umphreys_mcgee.rb b/lib/faker/music/umphreys_mcgee.rb
index 2bb494d7c6..a336aab4ac 100644
--- a/lib/faker/music/umphreys_mcgee.rb
+++ b/lib/faker/music/umphreys_mcgee.rb
@@ -4,6 +4,15 @@ module Faker
   class Music
     class UmphreysMcgee < Base
       class << self
+        ##
+        # Produces the name of a song by Umphrey's McGee.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::Music::UmphreysMcgee.song #=> "Dump City"
+        #
+        # @faker.version 1.8.3
         def song
           fetch('umphreys_mcgee.song')
         end

From 3f8c471b2e1cb753206bf04a15f4ee5aacfb8ec2 Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 17:49:13 -0600
Subject: [PATCH 02/31] Add YARD docs for Buffy the Vampire Slayer.

---
 lib/faker/tv_shows/buffy.rb | 45 +++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/lib/faker/tv_shows/buffy.rb b/lib/faker/tv_shows/buffy.rb
index d6fecf700e..10923ed6ec 100644
--- a/lib/faker/tv_shows/buffy.rb
+++ b/lib/faker/tv_shows/buffy.rb
@@ -6,22 +6,67 @@ class Buffy < Base
       flexible :buffy
 
       class << self
+        ##
+        # Produces a character from Buffy the Vampire Slayer.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Buffy.character #=> "Buffy Summers"
+        #
+        # @faker.version 1.9.2
         def character
           fetch('buffy.characters')
         end
 
+        ##
+        # Produces a quote from Buffy the Vampire Slayer.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Buffy.quote #=> "If the apocalypse comes, beep me."
+        #
+        # @faker.version 1.9.2
         def quote
           fetch('buffy.quotes')
         end
 
+        ##
+        # Produces a celebrity from Buffy the Vampire Slayer.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Buffy.celebrity #=> "John Ritter"
+        #
+        # @faker.version 1.9.2
         def celebrity
           fetch('buffy.celebrities')
         end
 
+        ##
+        # Produces a big bad from Buffy the Vampire Slayer.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Buffy.big_bad #=> "Glory"
+        #
+        # @faker.version 1.9.2
         def big_bad
           fetch('buffy.big_bads')
         end
 
+        ##
+        # Produces an episode from Buffy the Vampire Slayer.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Buffy.episode #=> "Once More, with Feeling"
+        #
+        # @faker.version 1.9.2
         def episode
           fetch('buffy.episodes')
         end

From 20a7521994939601a2a93c9aeb04d4872105d5ad Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 17:53:27 -0600
Subject: [PATCH 03/31] Add YARD docs for Aqua Teen Hunger Force.

---
 lib/faker/tv_shows/aqua_teen_hunger_force.rb | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/lib/faker/tv_shows/aqua_teen_hunger_force.rb b/lib/faker/tv_shows/aqua_teen_hunger_force.rb
index f7fb962baa..01f120d8a2 100644
--- a/lib/faker/tv_shows/aqua_teen_hunger_force.rb
+++ b/lib/faker/tv_shows/aqua_teen_hunger_force.rb
@@ -6,6 +6,15 @@ class AquaTeenHungerForce < Base
       flexible :aqua_teen_hunger_force
 
       class << self
+        ##
+        # Produces a character from Aqua Teen Hunger Force.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::AquaTeenHungerForce.character #=> "Master Shake"
+        #
+        # @faker.version 1.8.5
         def character
           fetch('aqua_teen_hunger_force.character')
         end

From b888f42ae1984a7c4d071a7fcde249ef8bc27ce8 Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 17:53:35 -0600
Subject: [PATCH 04/31] Add YARD docs for BoJack Horseman.

---
 lib/faker/tv_shows/bojack_horseman.rb | 28 +++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/lib/faker/tv_shows/bojack_horseman.rb b/lib/faker/tv_shows/bojack_horseman.rb
index 63bd0545ca..7539ab5677 100644
--- a/lib/faker/tv_shows/bojack_horseman.rb
+++ b/lib/faker/tv_shows/bojack_horseman.rb
@@ -6,14 +6,42 @@ class BojackHorseman < Base
       flexible :bojack_horseman
 
       class << self
+        ##
+        # Produces a character from BoJack Horseman.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::BojackHorseman.character #=> "BoJack Horseman"
+        #
+        # @faker.version 1.9.0
         def character
           fetch('bojack_horseman.characters')
         end
 
+        ##
+        # Produces a tongue twister from BoJack Horseman.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::BojackHorseman.tongue_twister #=> "Did you steal a meal from Neal McBeal the Navy Seal?"
+        #
+        # @faker.version 1.9.0
         def tongue_twister
           fetch('bojack_horseman.tongue_twisters')
         end
 
+        ##
+        # Produces a quote from BoJack Horseman.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::BojackHorseman.quote
+        #     #=> "Not understanding that you're a horrible person doesn't make you less of a horrible person."
+        #
+        # @faker.version 1.9.0
         def quote
           fetch('bojack_horseman.quotes')
         end

From e3b4bdbab73eaf7c9381970eda498ee606bba707 Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 18:10:39 -0600
Subject: [PATCH 05/31] Add YARD docs for Community.

---
 lib/faker/tv_shows/community.rb | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/lib/faker/tv_shows/community.rb b/lib/faker/tv_shows/community.rb
index 74ab2f6072..ebee983011 100644
--- a/lib/faker/tv_shows/community.rb
+++ b/lib/faker/tv_shows/community.rb
@@ -6,10 +6,29 @@ class Community < Base
       flexible :community
 
       class << self
+        ##
+        # Produces a character from Community.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Community.characters #=> "Jeff Winger"
+        #
+        # @faker.version 1.9.0
         def characters
           fetch('community.characters')
         end
 
+        ##
+        # Produces a quote from Community.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Community.quotes
+        #     #=> "I fear a political career could shine a negative light on my drug dealing."
+        #
+        # @faker.version 1.9.0
         def quotes
           fetch('community.quotes')
         end

From 998edf6209169932e74db0d25325f2d8236197b2 Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 18:13:02 -0600
Subject: [PATCH 06/31] Add YARD docs for Hey Arnold!

---
 lib/faker/tv_shows/hey_arnold.rb | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/lib/faker/tv_shows/hey_arnold.rb b/lib/faker/tv_shows/hey_arnold.rb
index 3e0377e8f0..4126a238a2 100644
--- a/lib/faker/tv_shows/hey_arnold.rb
+++ b/lib/faker/tv_shows/hey_arnold.rb
@@ -6,14 +6,41 @@ class HeyArnold < Base
       flexible :hey_arnold
 
       class << self
+        ##
+        # Produces a character from Hey Arnold!
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::HeyArnold.character #=> "Arnold"
+        #
+        # @faker.version 1.8.0
         def character
           fetch('hey_arnold.characters')
         end
 
+        ##
+        # Produces a location from Hey Arnold!
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::HeyArnold.location #=> "Big Bob's Beeper Emporium"
+        #
+        # @faker.version 1.8.0
         def location
           fetch('hey_arnold.locations')
         end
 
+        ##
+        # Produces a quote from Hey Arnold!
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::HeyArnold.quote #=> "Stoop Kid's afraid to leave his stoop!"
+        #
+        # @faker.version 1.8.0
         def quote
           fetch('hey_arnold.quotes')
         end

From df82ed51fcebf61dcb915eeb07ec9b1264cf9bdd Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 18:14:53 -0600
Subject: [PATCH 07/31] Add YARD docs for Family Guy.

---
 lib/faker/tv_shows/family_guy.rb | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/lib/faker/tv_shows/family_guy.rb b/lib/faker/tv_shows/family_guy.rb
index d5f3b60ee3..71c94a2196 100644
--- a/lib/faker/tv_shows/family_guy.rb
+++ b/lib/faker/tv_shows/family_guy.rb
@@ -6,14 +6,42 @@ class FamilyGuy < Base
       flexible :family_guy
 
       class << self
+        ##
+        # Produces a character from Family Guy.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::FamilyGuy.character #=> "Peter Griffin"
+        #
+        # @faker.version 1.8.0
         def character
           fetch('family_guy.character')
         end
 
+        ##
+        # Produces a location from Family Guy.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::FamilyGuy.location #=> "James Woods High"
+        #
+        # @faker.version 1.8.0
         def location
           fetch('family_guy.location')
         end
 
+        ##
+        # Produces a quote from Family Guy.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::FamilyGuy.quote
+        #     #=> "It's Peanut Butter Jelly Time."
+        #
+        # @faker.version 1.8.0
         def quote
           fetch('family_guy.quote')
         end

From 302a30e9b6487c93b2902721f76293d12b50f403 Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 18:16:21 -0600
Subject: [PATCH 08/31] Add YARD docs for Friends.

---
 lib/faker/tv_shows/friends.rb | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/lib/faker/tv_shows/friends.rb b/lib/faker/tv_shows/friends.rb
index 96ee256564..13c63ab5f7 100644
--- a/lib/faker/tv_shows/friends.rb
+++ b/lib/faker/tv_shows/friends.rb
@@ -6,14 +6,41 @@ class Friends < Base
       flexible :friends
 
       class << self
+        ##
+        # Produces a character from Friends.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Friends.character #=> "Rachel Green"
+        #
+        # @faker.version 1.7.3
         def character
           fetch('friends.characters')
         end
 
+        ##
+        # Produces a location from Friends.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Friends.location #=> "Central Perk"
+        #
+        # @faker.version 1.7.3
         def location
           fetch('friends.locations')
         end
 
+        ##
+        # Produces a quote from Friends.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Friends.quote #=> "We were on a break!"
+        #
+        # @faker.version 1.7.3
         def quote
           fetch('friends.quotes')
         end

From a0c0504a0f14aafbab0843c6766a5cee1a500867 Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 18:18:16 -0600
Subject: [PATCH 09/31] Add YARD docs for Game of Thrones.

---
 lib/faker/tv_shows/game_of_thrones.rb | 47 +++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/lib/faker/tv_shows/game_of_thrones.rb b/lib/faker/tv_shows/game_of_thrones.rb
index 85042a000d..0c1bc4bcdc 100644
--- a/lib/faker/tv_shows/game_of_thrones.rb
+++ b/lib/faker/tv_shows/game_of_thrones.rb
@@ -6,22 +6,69 @@ class GameOfThrones < Base
       flexible :game_of_thrones
 
       class << self
+        ##
+        # Produces a character from Game of Thrones.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::GameOfThrones.character #=> "Tyrion Lannister"
+        #
+        # @faker.version 1.6.6
         def character
           fetch('game_of_thrones.characters')
         end
 
+        ##
+        # Produces a house from Game of Thrones.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::GameOfThrones.house #=> "Stark"
+        #
+        # @faker.version 1.6.6
         def house
           fetch('game_of_thrones.houses')
         end
 
+        ##
+        # Produces a city from Game of Thrones.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::GameOfThrones.city #=> "Lannisport"
+        #
+        # @faker.version 1.6.6
         def city
           fetch('game_of_thrones.cities')
         end
 
+
+        ##
+        # Produces a quote from Game of Thrones.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::GameOfThrones.quote
+        #     #=> "Never forget who you are. The rest of the world won't. Wear it like an armor and it can never be used against you."
+        #
+        # @faker.version 1.6.6
         def quote
           fetch('game_of_thrones.quotes')
         end
 
+        ##
+        # Produces a dragon from Game of Thrones.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::GameOfThrones.dragon #=> "Drogon"
+        #
+        # @faker.version 1.6.6
         def dragon
           fetch('game_of_thrones.dragons')
         end

From fe7fd5765c083ad42e5b4ee7103dedc3fe0b6172 Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 18:32:58 -0600
Subject: [PATCH 10/31] Add YARD docs for How I Met Your Mother.

---
 lib/faker/tv_shows/how_i_met_your_mother.rb | 37 +++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/lib/faker/tv_shows/how_i_met_your_mother.rb b/lib/faker/tv_shows/how_i_met_your_mother.rb
index 2ed3864dc5..c5799fa034 100644
--- a/lib/faker/tv_shows/how_i_met_your_mother.rb
+++ b/lib/faker/tv_shows/how_i_met_your_mother.rb
@@ -6,18 +6,55 @@ class HowIMetYourMother < Base
       flexible :how_i_met_your_mother
 
       class << self
+        ##
+        # Produces a character from How I Met Your Mother.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::HowIMetYourMother.character #=> "Barney Stinson"
+        #
+        # @faker.version 1.8.0
         def character
           fetch('how_i_met_your_mother.character')
         end
 
+        ##
+        # Produces a catch phrase from How I Met Your Mother.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::HowIMetYourMother.catch_phrase #=> "Legendary"
+        #
+        # @faker.version 1.8.0
         def catch_phrase
           fetch('how_i_met_your_mother.catch_phrase')
         end
 
+        ##
+        # Produces a high five from How I Met Your Mother.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::HowIMetYourMother.high_five #=> "Relapse Five"
+        #
+        # @faker.version 1.8.0
         def high_five
           fetch('how_i_met_your_mother.high_five')
         end
 
+        ##
+        # Produces a quote from How I Met Your Mother.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::HowIMetYourMother.quote
+        #     #=> "Whenever I’m sad, I stop being sad and be awesome instead."
+        #
+        # @faker.version 1.8.0
         def quote
           fetch('how_i_met_your_mother.quote')
         end

From f6f5ffd926c65bf5278fd033791b96916fb5eee0 Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 18:35:48 -0600
Subject: [PATCH 11/31] Add YARD docs for Michael Scott.

---
 lib/faker/tv_shows/michael_scott.rb | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/lib/faker/tv_shows/michael_scott.rb b/lib/faker/tv_shows/michael_scott.rb
index 9e2ff8c042..c5ff88011b 100644
--- a/lib/faker/tv_shows/michael_scott.rb
+++ b/lib/faker/tv_shows/michael_scott.rb
@@ -4,9 +4,22 @@ module Faker
   class TvShows
     class MichaelScott < Base
       class << self
+        # rubocop:disable Style/AsciiComments
+
+        ##
+        # Produces a quote from Michael Scott.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::MichaelScott.quote
+        #     #=> "I am Beyoncé, always."
+        #
+        # @faker.version 1.9.0
         def quote
           fetch('michael_scott.quotes')
         end
+        # rubocop:enable Style/AsciiComments
       end
     end
   end

From 88a629c16d164feb6e383a10dd636227262f0ff6 Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 18:37:15 -0600
Subject: [PATCH 12/31] Fix some Rubocop warnings.

---
 lib/faker/tv_shows/game_of_thrones.rb       | 1 -
 lib/faker/tv_shows/how_i_met_your_mother.rb | 2 +-
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/lib/faker/tv_shows/game_of_thrones.rb b/lib/faker/tv_shows/game_of_thrones.rb
index 0c1bc4bcdc..4469772c36 100644
--- a/lib/faker/tv_shows/game_of_thrones.rb
+++ b/lib/faker/tv_shows/game_of_thrones.rb
@@ -45,7 +45,6 @@ def city
           fetch('game_of_thrones.cities')
         end
 
-
         ##
         # Produces a quote from Game of Thrones.
         #
diff --git a/lib/faker/tv_shows/how_i_met_your_mother.rb b/lib/faker/tv_shows/how_i_met_your_mother.rb
index c5799fa034..f8a985aec0 100644
--- a/lib/faker/tv_shows/how_i_met_your_mother.rb
+++ b/lib/faker/tv_shows/how_i_met_your_mother.rb
@@ -52,7 +52,7 @@ def high_five
         #
         # @example
         #   Faker::TvShows::HowIMetYourMother.quote
-        #     #=> "Whenever I’m sad, I stop being sad and be awesome instead."
+        #     #=> "Whenever I'm sad, I stop being sad and be awesome instead."
         #
         # @faker.version 1.8.0
         def quote

From 7b1e178f380bf02e8f83b2817d6a4d2cb2b02e47 Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 18:38:06 -0600
Subject: [PATCH 13/31] Add YARD docs for New Girl.

---
 lib/faker/tv_shows/new_girl.rb | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/lib/faker/tv_shows/new_girl.rb b/lib/faker/tv_shows/new_girl.rb
index f5824a543b..d417312abb 100644
--- a/lib/faker/tv_shows/new_girl.rb
+++ b/lib/faker/tv_shows/new_girl.rb
@@ -6,10 +6,29 @@ class NewGirl < Base
       flexible :new_girl
 
       class << self
+        ##
+        # Produces a character from New Girl.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::NewGirl.character #=> "Jessica Day"
+        #
+        # @faker.version 1.9.0
         def character
           fetch('new_girl.characters')
         end
 
+        ##
+        # Produces a quote from New Girl.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::NewGirl.quote
+        #     #=> "Are you cooking a frittata in a sauce pan? What is this - prison?"
+        #
+        # @faker.version 1.9.0
         def quote
           fetch('new_girl.quotes')
         end

From bcda93b71170fc3c302581356a60cbc5984ae594 Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 18:40:13 -0600
Subject: [PATCH 14/31] Add YARD docs for Parks and Recreation.

---
 lib/faker/tv_shows/parks_and_rec.rb | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/lib/faker/tv_shows/parks_and_rec.rb b/lib/faker/tv_shows/parks_and_rec.rb
index cb0ef95463..614813232e 100644
--- a/lib/faker/tv_shows/parks_and_rec.rb
+++ b/lib/faker/tv_shows/parks_and_rec.rb
@@ -6,10 +6,28 @@ class ParksAndRec < Base
       flexible :parks_and_rec
 
       class << self
+        ##
+        # Produces a character from Parks and Recreation.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::ParksAndRec.character #=> "Leslie Knope"
+        #
+        # @faker.version 1.9.0
         def character
           fetch('parks_and_rec.characters')
         end
 
+        ##
+        # Produces a city from Parks and Recreation.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::ParksAndRec.city #=> "Pawnee"
+        #
+        # @faker.version 1.9.0
         def city
           fetch('parks_and_rec.cities')
         end

From 0d19e792cfe6faeb6bf579dfe1f717908465e24a Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 18:42:09 -0600
Subject: [PATCH 15/31] Add YARD docs for Rick and Morty.

---
 lib/faker/tv_shows/rick_and_morty.rb | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/lib/faker/tv_shows/rick_and_morty.rb b/lib/faker/tv_shows/rick_and_morty.rb
index 1c292fb8ed..aac1a00479 100644
--- a/lib/faker/tv_shows/rick_and_morty.rb
+++ b/lib/faker/tv_shows/rick_and_morty.rb
@@ -6,14 +6,42 @@ class RickAndMorty < Base
       flexible :rick_and_morty
 
       class << self
+        ##
+        # Produces a character from Rick and Morty.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::RickAndMorty.character #=> "Rick Sanchez"
+        #
+        # @faker.version 1.8.0
         def character
           fetch('rick_and_morty.characters')
         end
 
+        ##
+        # Produces a location from Rick and Morty.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::RickAndMorty.location #=> "Dimension C-132"
+        #
+        # @faker.version 1.8.0
         def location
           fetch('rick_and_morty.locations')
         end
 
+        ##
+        # Produces a quote from Rick and Morty.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::RickAndMorty.quote
+        #     #=> "Ohh yea, you gotta get schwifty."
+        #
+        # @faker.version 1.8.0
         def quote
           fetch('rick_and_morty.quotes')
         end

From 9eb9b7d03e42921104b5ab5482ff76937b31c078 Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 18:44:02 -0600
Subject: [PATCH 16/31] Add YARD docs for RuPaul's Drag Race.

---
 lib/faker/tv_shows/ru_paul.rb | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/lib/faker/tv_shows/ru_paul.rb b/lib/faker/tv_shows/ru_paul.rb
index 7b5bffdb6b..b45b4ead37 100644
--- a/lib/faker/tv_shows/ru_paul.rb
+++ b/lib/faker/tv_shows/ru_paul.rb
@@ -6,10 +6,28 @@ class RuPaul < Base
       flexible :rupaul
 
       class << self
+        ##
+        # Produces a quote from RuPaul's Drag Race.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::RuPaul.quote #=> "That's Funny, Tell Another One."
+        #
+        # @faker.version 1.8.0
         def quote
           fetch('rupaul.quotes')
         end
 
+        ##
+        # Produces a queen from RuPaul's Drag Race.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::RuPaul.queen #=> "Latrice Royale"
+        #
+        # @faker.version 1.8.0
         def queen
           fetch('rupaul.queens')
         end

From edb65dd82f7f53c42e8c503af8a1b513b76d40b0 Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 18:46:41 -0600
Subject: [PATCH 17/31] Add YARD docs for Seinfeld.

---
 lib/faker/tv_shows/seinfeld.rb | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/lib/faker/tv_shows/seinfeld.rb b/lib/faker/tv_shows/seinfeld.rb
index 07a20e1855..9c7e37a7cc 100644
--- a/lib/faker/tv_shows/seinfeld.rb
+++ b/lib/faker/tv_shows/seinfeld.rb
@@ -6,14 +6,42 @@ class Seinfeld < Base
       flexible :seinfeld
 
       class << self
+        ##
+        # Produces a business from Seinfeld.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Seinfeld.business #=> "Kruger Industrial Smoothing"
+        #
+        # @faker.version 1.9.2
         def business
           fetch('seinfeld.business')
         end
 
+        ##
+        # Produces a character from Seinfeld.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Seinfeld.character #=> "George Costanza"
+        #
+        # @faker.version 1.8.3
         def character
           fetch('seinfeld.character')
         end
 
+        ##
+        # Produces a quote from Seinfeld.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Seinfeld.quote
+        #     #=> "I'm not a lesbian. I hate men, but I'm not a lesbian."
+        #
+        # @faker.version 1.8.3
         def quote
           fetch('seinfeld.quote')
         end

From 5bf34f5791081145a8440caaed734d092702f30b Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 18:51:54 -0600
Subject: [PATCH 18/31] Add YARD docs for Silicon Valley.

---
 lib/faker/tv_shows/silicon_valley.rb | 75 ++++++++++++++++++++++++++++
 1 file changed, 75 insertions(+)

diff --git a/lib/faker/tv_shows/silicon_valley.rb b/lib/faker/tv_shows/silicon_valley.rb
index 86298fb11a..addf9546bc 100644
--- a/lib/faker/tv_shows/silicon_valley.rb
+++ b/lib/faker/tv_shows/silicon_valley.rb
@@ -6,34 +6,109 @@ class SiliconValley < Base
       flexible :silicon_valley
 
       class << self
+        ##
+        # Produces a character from Silicon Valley.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::SiliconValley.character #=> "Jian Yang"
+        #
+        # @faker.version 1.8.5
         def character
           fetch('silicon_valley.characters')
         end
 
+        ##
+        # Produces a company from Silicon Valley.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::SiliconValley.company #=> "Bachmanity"
+        #
+        # @faker.version 1.8.5
         def company
           fetch('silicon_valley.companies')
         end
 
+        ##
+        # Produces a quote from Silicon Valley.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::SiliconValley.quote
+        #     #=> "I don't want to live in a world where someone else is making the world a better place better than we are."
+        #
+        # @faker.version 1.8.5
         def quote
           fetch('silicon_valley.quotes')
         end
 
+        ##
+        # Produces an app from Silicon Valley.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::SiliconValley.app #=> "Nip Alert"
+        #
+        # @faker.version 1.8.5
         def app
           fetch('silicon_valley.apps')
         end
 
+        ##
+        # Produces an invention from Silicon Valley.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::SiliconValley.invention
+        #     #=> "Tres Comas Tequila"
+        #
+        # @faker.version 1.8.5
         def invention
           fetch('silicon_valley.inventions')
         end
 
+        ##
+        # Produces a motto from Silicon Valley.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::SiliconValley.motto
+        #     #=> "Our products are products, producing unrivaled results"
+        #
+        # @faker.version 1.8.5
         def motto
           fetch('silicon_valley.mottos')
         end
 
+        ##
+        # Produces a URL from Silicon Valley.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::SiliconValley.url #=> "http://www.piedpiper.com"
+        #
+        # @faker.version 1.8.5
         def url
           fetch('silicon_valley.urls')
         end
 
+        ##
+        # Produces an email address from Silicon Valley.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::SiliconValley.email #=> "richard@piedpiper.test"
+        #
+        # @faker.version 1.9.0
         def email
           fetch('silicon_valley.email')
         end

From 900728e4a86901a6c0e1af8c97904f05822b738f Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 18:53:49 -0600
Subject: [PATCH 19/31] Add YARD docs for The Simpsons

---
 lib/faker/tv_shows/simpsons.rb | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/lib/faker/tv_shows/simpsons.rb b/lib/faker/tv_shows/simpsons.rb
index cd6d58e0a0..b631c41ffa 100644
--- a/lib/faker/tv_shows/simpsons.rb
+++ b/lib/faker/tv_shows/simpsons.rb
@@ -6,14 +6,42 @@ class Simpsons < Base
       flexible :simpsons
 
       class << self
+        ##
+        # Produces a character from The Simpsons.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Simpsons.character #=> "Charles Montgomery Burns"
+        #
+        # @faker.version 1.8.0
         def character
           fetch('simpsons.characters')
         end
 
+        ##
+        # Produces a location from The Simpsons.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Simpsons.location #=> "Moe's Tavern"
+        #
+        # @faker.version 1.8.0
         def location
           fetch('simpsons.locations')
         end
 
+        ##
+        # Produces a quote from The Simpsons.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Simpsons.quote
+        #     #=> "It takes two to lie: one to lie and one to listen."
+        #
+        # @faker.version 1.8.0
         def quote
           fetch('simpsons.quotes')
         end

From 40880b7fa738cb8de29f7766ab3701860872b7e5 Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 18:55:20 -0600
Subject: [PATCH 20/31] Add YARD docs for South Park.

---
 lib/faker/tv_shows/south_park.rb | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/lib/faker/tv_shows/south_park.rb b/lib/faker/tv_shows/south_park.rb
index e796b36061..7f4e239849 100644
--- a/lib/faker/tv_shows/south_park.rb
+++ b/lib/faker/tv_shows/south_park.rb
@@ -6,10 +6,29 @@ class SouthPark < Base
       flexible :south_park
 
       class << self
+        ##
+        # Produces a character from South Park.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::SouthPark.character #=> "Mr. Garrison"
+        #
+        # @faker.version 1.9.2
         def character
           fetch('south_park.characters')
         end
 
+        ##
+        # Produces a quote from South Park.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::SouthPark.quote
+        #     #=> "I'm just getting a little cancer Stan."
+        #
+        # @faker.version 1.9.2
         def quote
           fetch('south_park.quotes')
         end

From 15f1c9b649ca123e0a0be2fb6447d682cfe103ac Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 18:56:55 -0600
Subject: [PATCH 21/31] Add YARD docs for Star Trek.

---
 lib/faker/tv_shows/star_trek.rb | 36 +++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/lib/faker/tv_shows/star_trek.rb b/lib/faker/tv_shows/star_trek.rb
index 9191cb5c25..8ca83e3cee 100644
--- a/lib/faker/tv_shows/star_trek.rb
+++ b/lib/faker/tv_shows/star_trek.rb
@@ -6,18 +6,54 @@ class StarTrek < Base
       flexible :star_trek
 
       class << self
+        ##
+        # Produces a character from Star Trek.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::StarTrek.character #=> "Spock"
+        #
+        # @faker.version 1.8.0
         def character
           fetch('star_trek.character')
         end
 
+        ##
+        # Produces a location from Star Trek.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::StarTrek.location #=> "Cardassia"
+        #
+        # @faker.version 1.8.0
         def location
           fetch('star_trek.location')
         end
 
+        ##
+        # Produces a specie from Star Trek.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::StarTrek.specie #=> "Ferengi"
+        #
+        # @faker.version 1.8.0
         def specie
           fetch('star_trek.specie')
         end
 
+        ##
+        # Produces a villain from Star Trek.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::StarTrek.villain #=> "Khan Noonien Singh"
+        #
+        # @faker.version 1.8.0
         def villain
           fetch('star_trek.villain')
         end

From 8cd365b94180289fe33a42f9419846e81adea881 Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 18:59:06 -0600
Subject: [PATCH 22/31] Add YARD docs for Stargate.

---
 lib/faker/tv_shows/stargate.rb | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/lib/faker/tv_shows/stargate.rb b/lib/faker/tv_shows/stargate.rb
index 0cec2ab21a..0fe34a3ec1 100644
--- a/lib/faker/tv_shows/stargate.rb
+++ b/lib/faker/tv_shows/stargate.rb
@@ -6,14 +6,42 @@ class Stargate < Base
       flexible :stargate
 
       class << self
+        ##
+        # Produces a character from Stargate.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Stargate.character #=> "Jack O'Neill"
+        #
+        # @faker.version 1.8.5
         def character
           fetch('stargate.characters')
         end
 
+        ##
+        # Produces a planet from Stargate.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Stargate.planet #=> "Abydos"
+        #
+        # @faker.version 1.8.5
         def planet
           fetch('stargate.planets')
         end
 
+        ##
+        # Produces a quote from Stargate.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::Stargate.quote
+        #     #=> "General, request permission to beat the crap out of this man."
+        #
+        # @faker.version 1.8.5
         def quote
           fetch('stargate.quotes')
         end

From 74469eca63202eec0ab098892b4dd7ae87953144 Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 19:00:19 -0600
Subject: [PATCH 23/31] Add YARD docs for Stranger Things.

---
 lib/faker/tv_shows/stranger_things.rb | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/lib/faker/tv_shows/stranger_things.rb b/lib/faker/tv_shows/stranger_things.rb
index b6cf65229f..2b2febd030 100644
--- a/lib/faker/tv_shows/stranger_things.rb
+++ b/lib/faker/tv_shows/stranger_things.rb
@@ -6,10 +6,29 @@ class StrangerThings < Base
       flexible :stranger_things
 
       class << self
+        ##
+        # Produces a character from Stranger Things.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::StrangerThings.character #=> "six"
+        #
+        # @faker.version 1.9.0
         def quote
           fetch('stranger_things.quote')
         end
 
+        ##
+        # Produces a quote from Stranger Things.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::StrangerThings.quote
+        #     #=> "Friends don't lie."
+        #
+        # @faker.version 1.9.0
         def character
           fetch('stranger_things.character')
         end

From 7a580523ee79a7db090aa861ceb6e1b1067c667b Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 19:02:08 -0600
Subject: [PATCH 24/31] Add YARD docs for The Expanse.

---
 lib/faker/tv_shows/the_expanse.rb | 36 +++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/lib/faker/tv_shows/the_expanse.rb b/lib/faker/tv_shows/the_expanse.rb
index dfb3229793..e987ec9186 100644
--- a/lib/faker/tv_shows/the_expanse.rb
+++ b/lib/faker/tv_shows/the_expanse.rb
@@ -6,18 +6,54 @@ class TheExpanse < Base
       flexible :the_expanse
 
       class << self
+        ##
+        # Produces a character from The Expanse.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::TheExpanse.character #=> "Jim Holden"
+        #
+        # @faker.version 1.9.2
         def character
           fetch('the_expanse.characters')
         end
 
+        ##
+        # Produces a quote from The Expanse.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::TheExpanse.quote #=> "I am that guy."
+        #
+        # @faker.version 1.9.2
         def quote
           fetch('the_expanse.quotes')
         end
 
+        ##
+        # Produces a location from The Expanse.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::TheExpanse.location #=> "Ganymede"
+        #
+        # @faker.version 1.9.2
         def location
           fetch('the_expanse.locations')
         end
 
+        ##
+        # Produces a ship from The Expanse.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::TheExpanse.ship #=> "Nauvoo"
+        #
+        # @faker.version 1.9.2
         def ship
           fetch('the_expanse.ships')
         end

From cd06c8000723ce63689430654410785010cb7735 Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 19:04:37 -0600
Subject: [PATCH 25/31] Add YARD docs for The Fresh Prince of Bel-Air.

---
 .../tv_shows/the_fresh_prince_of_bel_air.rb   | 28 +++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/lib/faker/tv_shows/the_fresh_prince_of_bel_air.rb b/lib/faker/tv_shows/the_fresh_prince_of_bel_air.rb
index 5fe089c749..3698a563b0 100644
--- a/lib/faker/tv_shows/the_fresh_prince_of_bel_air.rb
+++ b/lib/faker/tv_shows/the_fresh_prince_of_bel_air.rb
@@ -6,14 +6,42 @@ class TheFreshPrinceOfBelAir < Base
       flexible :the_fresh_prince_of_bel_air
 
       class << self
+        ##
+        # Produces a character from The Fresh Prince of Bel-Air.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::TheFreshPrinceOfBelAir.character #=> "Will Smith"
+        #
+        # @faker.version 1.8.3
         def character
           fetch('the_fresh_prince_of_bel_air.characters')
         end
 
+        ##
+        # Produces a celebrity from The Fresh Prince of Bel-Air.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::TheFreshPrinceOfBelAir.celebrity #=> "Quincy Jones"
+        #
+        # @faker.version 1.8.3
         def celebrity
           fetch('the_fresh_prince_of_bel_air.celebrities')
         end
 
+        ##
+        # Produces a quote from The Fresh Prince of Bel-Air.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::TheFreshPrinceOfBelAir.quote
+        #     #=> "Girl, you look so good, I would marry your brother just to get in your family."
+        #
+        # @faker.version 1.8.3
         def quote
           fetch('the_fresh_prince_of_bel_air.quotes')
         end

From 83b39b2cce1ae96d8b22b0409f4bd522c62ff1e3 Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 19:06:55 -0600
Subject: [PATCH 26/31] Add YARD docs for The IT Crowd.

---
 lib/faker/tv_shows/the_it_crowd.rb | 37 ++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/lib/faker/tv_shows/the_it_crowd.rb b/lib/faker/tv_shows/the_it_crowd.rb
index 56602ff90a..32c34b0729 100644
--- a/lib/faker/tv_shows/the_it_crowd.rb
+++ b/lib/faker/tv_shows/the_it_crowd.rb
@@ -6,18 +6,55 @@ class TheITCrowd < Base
       flexible :the_it_crowd
 
       class << self
+        ##
+        # Produces an actor from The IT Crowd.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::TheITCrowd.actor #=> "Chris O'Dowd"
+        #
+        # @faker.version 1.9.0
         def actor
           fetch('the_it_crowd.actors')
         end
 
+        ##
+        # Produces a character from The IT Crowd.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::TheITCrowd.character #=> "Roy Trenneman"
+        #
+        # @faker.version 1.9.0
         def character
           fetch('the_it_crowd.characters')
         end
 
+        ##
+        # Produces an email from The IT Crowd.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::TheITCrowd.email #=> "roy.trenneman@reynholm.test"
+        #
+        # @faker.version 1.9.0
         def email
           fetch('the_it_crowd.emails')
         end
 
+        ##
+        # Produces a quote from The IT Crowd.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::TheITCrowd.quote
+        #     #=> "Hello, IT. Have you tried turning it off and on again?"
+        #
+        # @faker.version 1.9.0
         def quote
           fetch('the_it_crowd.quotes')
         end

From 7118cd9a9f3601abfefd4fa3632c3d3f85c7fcf7 Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 19:09:08 -0600
Subject: [PATCH 27/31] Add YARD docs for The Thick of It.

---
 lib/faker/tv_shows/the_thick_of_it.rb | 28 +++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/lib/faker/tv_shows/the_thick_of_it.rb b/lib/faker/tv_shows/the_thick_of_it.rb
index cbe984a1ff..c17572cffe 100644
--- a/lib/faker/tv_shows/the_thick_of_it.rb
+++ b/lib/faker/tv_shows/the_thick_of_it.rb
@@ -6,14 +6,42 @@ class TheThickOfIt < Base
       flexible :the_thick_of_it
 
       class << self
+        ##
+        # Produces a character from The Thick of It.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::TheThickOfIt.character #=> "Nicola Murray"
+        #
+        # @faker.version 1.8.5
         def character
           fetch('the_thick_of_it.characters')
         end
 
+        ##
+        # Produces a department from The Thick of It.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::TheThickOfIt.department #=> "Shadow Cabinet"
+        #
+        # @faker.version 1.8.5
         def department
           fetch('the_thick_of_it.departments')
         end
 
+        ##
+        # Produces a position from The Thick of It.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::TheThickOfIt.position
+        #     #=> "Director of Communications"
+        #
+        # @faker.version 1.8.5
         def position
           fetch('the_thick_of_it.positions')
         end

From 29fa3ffccb6188a087b1409b523192fcaae58e7a Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 19:10:24 -0600
Subject: [PATCH 28/31] Add YARD docs for Twin Peaks.

---
 lib/faker/tv_shows/twin_peaks.rb | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/lib/faker/tv_shows/twin_peaks.rb b/lib/faker/tv_shows/twin_peaks.rb
index fa2f84c2d0..c3f37be6c1 100644
--- a/lib/faker/tv_shows/twin_peaks.rb
+++ b/lib/faker/tv_shows/twin_peaks.rb
@@ -6,14 +6,42 @@ class TwinPeaks < Base
       flexible :twin_peaks
 
       class << self
+        ##
+        # Produces a character from Twin Peaks.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::TwinPeaks.character #=> "Dale Cooper"
+        #
+        # @faker.version 1.7.0
         def character
           fetch('twin_peaks.characters')
         end
 
+        ##
+        # Produces a location from Twin Peaks.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::TwinPeaks.location #=> "Black Lodge"
+        #
+        # @faker.version 1.7.0
         def location
           fetch('twin_peaks.locations')
         end
 
+        ##
+        # Produces a quote from Twin Peaks.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::TwinPeaks.quote
+        #     #=> "The owls are not what they seem."
+        #
+        # @faker.version 1.7.0
         def quote
           fetch('twin_peaks.quotes')
         end

From 0a1387323502a0fa9e02b739a839e39092266e0d Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 19:13:23 -0600
Subject: [PATCH 29/31] Add YARD docs for The Venture Bros.

---
 lib/faker/tv_shows/venture_bros.rb | 38 ++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/lib/faker/tv_shows/venture_bros.rb b/lib/faker/tv_shows/venture_bros.rb
index 02a7e09221..4790c8fd79 100644
--- a/lib/faker/tv_shows/venture_bros.rb
+++ b/lib/faker/tv_shows/venture_bros.rb
@@ -6,18 +6,56 @@ class VentureBros < Base
       flexible :venture_bros
 
       class << self
+        ##
+        # Produces a character from The Venture Bros.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::VentureBros.character #=> "Scaramantula"
+        #
+        # @faker.version 1.8.3
         def character
           fetch('venture_bros.character')
         end
 
+        ##
+        # Produces an organization from The Venture Bros.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::VentureBros.organization
+        #     #=> "Guild of Calamitous Intent"
+        #
+        # @faker.version 1.8.3
         def organization
           fetch('venture_bros.organization')
         end
 
+        ##
+        # Produces a vehicle from The Venture Bros.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::VentureBros.vehicle #=> "Monarchmobile"
+        #
+        # @faker.version 1.8.3
         def vehicle
           fetch('venture_bros.vehicle')
         end
 
+        ##
+        # Produces a quote from The Venture Bros.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::VentureBros.quote
+        #     #=> "Revenge, like gazpacho soup, is best served cold, precise, and merciless."
+        #
+        # @faker.version 1.8.3
         def quote
           fetch('venture_bros.quote')
         end

From 7af2b5e1e47da1156f7c8a3df6401c57f0948a71 Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 19:15:29 -0600
Subject: [PATCH 30/31] Add YARD docs for Dumb and Dumber.

---
 lib/faker/tv_shows/dumb_and_dumber.rb | 28 +++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/lib/faker/tv_shows/dumb_and_dumber.rb b/lib/faker/tv_shows/dumb_and_dumber.rb
index 873e391027..53aec85975 100644
--- a/lib/faker/tv_shows/dumb_and_dumber.rb
+++ b/lib/faker/tv_shows/dumb_and_dumber.rb
@@ -6,14 +6,42 @@ class DumbAndDumber < Base
       flexible :dumb_and_dumber
 
       class << self
+        ##
+        # Produces an actor from Dumb and Dumber.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::DumbAndDumber.actor #=> "Jim Carrey"
+        #
+        # @faker.version 1.8.5
         def actor
           fetch('dumb_and_dumber.actors')
         end
 
+        ##
+        # Produces a character from Dumb and Dumber.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::DumbAndDumber.character #=> "Harry Dunne"
+        #
+        # @faker.version 1.8.5
         def character
           fetch('dumb_and_dumber.characters')
         end
 
+        ##
+        # Produces a quote from Dumb and Dumber.
+        #
+        # @return [String]
+        #
+        # @example
+        #   Faker::TvShows::DumbAndDumber.quote
+        #     #=> "Why you going to the airport? Flying somewhere?"
+        #
+        # @faker.version 1.8.5
         def quote
           fetch('dumb_and_dumber.quotes')
         end

From 5ef0df6496045d43407c732972794ddc2735db2f Mon Sep 17 00:00:00 2001
From: Connor Shea <connor.james.shea@gmail.com>
Date: Fri, 20 Sep 2019 19:32:47 -0600
Subject: [PATCH 31/31] Fix grammar in Star Trek.

---
 lib/faker/tv_shows/star_trek.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/faker/tv_shows/star_trek.rb b/lib/faker/tv_shows/star_trek.rb
index 8ca83e3cee..933c991cf1 100644
--- a/lib/faker/tv_shows/star_trek.rb
+++ b/lib/faker/tv_shows/star_trek.rb
@@ -33,7 +33,7 @@ def location
         end
 
         ##
-        # Produces a specie from Star Trek.
+        # Produces a species from Star Trek.
         #
         # @return [String]
         #