Improve method and variable names on quickstart pages (en)

Replace single character names with more descriptive ones.

Author: stomar

en/documentation/quickstart/2/index.md

@@ -21,17 +21,17 @@ What if we want to say “Hello” a lot without getting our fingers all
 tired? We need to define a method!
 
 {% highlight irb %}
-irb(main):010:0> def h
+irb(main):010:0> def hi
 irb(main):011:1> puts "Hello World!"
 irb(main):012:1> end
-=> :h
+=> :hi
 {% endhighlight %}
 
-The code `def h` starts the definition of the method. It tells Ruby that
-we’re defining a method, that its name is `h`. The next line is the body
+The code `def hi` starts the definition of the method. It tells Ruby that
+we’re defining a method, that its name is `hi`. The next line is the body
 of the method, the same line we saw earlier: `puts "Hello World"`.
 Finally, the last line `end` tells Ruby we’re done defining the method.
-Ruby’s response `=> :h` tells us that it knows we’re done defining the
+Ruby’s response `=> :hi` tells us that it knows we’re done defining the
 method. This response could be `=> nil` for Ruby 2.0 and earlier versions.
 But, it's not important here, so let's go on.
 
@@ -40,10 +40,10 @@ But, it's not important here, so let's go on.
 Now let’s try running that method a few times:
 
 {% highlight irb %}
-irb(main):013:0> h
+irb(main):013:0> hi
 Hello World!
 => nil
-irb(main):014:0> h()
+irb(main):014:0> hi()
 Hello World!
 => nil
 {% endhighlight %}
@@ -54,14 +54,14 @@ that’s all you need. You can add empty parentheses if you’d like, but
 they’re not needed.
 
 What if we want to say hello to one person, and not the whole world?
-Just redefine `h` to take a name as a parameter.
+Just redefine `hi` to take a name as a parameter.
 
 {% highlight irb %}
-irb(main):015:0> def h(name)
+irb(main):015:0> def hi(name)
 irb(main):016:1> puts "Hello #{name}!"
 irb(main):017:1> end
-=> :h
-irb(main):018:0> h("Matz")
+=> :hi
+irb(main):018:0> hi("Matz")
 Hello Matz!
 => nil
 {% endhighlight %}
@@ -77,14 +77,14 @@ point. You can also use this to make sure that someone’s name is
 properly capitalized:
 
 {% highlight irb %}
-irb(main):019:0> def h(name = "World")
+irb(main):019:0> def hi(name = "World")
 irb(main):020:1> puts "Hello #{name.capitalize}!"
 irb(main):021:1> end
-=> :h
-irb(main):022:0> h "chris"
+=> :hi
+irb(main):022:0> hi "chris"
 Hello Chris!
 => nil
-irb(main):023:0> h
+irb(main):023:0> hi
 Hello World!
 => nil
 {% endhighlight %}
@@ -121,6 +121,6 @@ and a bunch of methods for that class. Also notice `@name`. This is an
 instance variable, and is available to all the methods of the class. As
 you can see it’s used by `say_hi` and `say_bye`.
 
-So how do we get this Greeter class set in motion? [Create an
-object.](../3/)
+So how do we get this Greeter class set in motion?
+[Create an object.](../3/)
 

en/documentation/quickstart/3/index.md

@@ -20,21 +20,21 @@ header: |
 Now let’s create a greeter object and use it:
 
 {% highlight irb %}
-irb(main):035:0> g = Greeter.new("Pat")
+irb(main):035:0> greeter = Greeter.new("Pat")
 => #<Greeter:0x16cac @name="Pat">
-irb(main):036:0> g.say_hi
+irb(main):036:0> greeter.say_hi
 Hi Pat!
 => nil
-irb(main):037:0> g.say_bye
+irb(main):037:0> greeter.say_bye
 Bye Pat, come back soon.
 => nil
 {% endhighlight %}
 
-Once the `g` object is created, it remembers that the name is Pat. Hmm,
+Once the `greeter` object is created, it remembers that the name is Pat. Hmm,
 what if we want to get at the name directly?
 
 {% highlight irb %}
-irb(main):038:0> g.@name
+irb(main):038:0> greeter.@name
 SyntaxError: compile error
 (irb):52: syntax error
         from (irb):52
@@ -81,11 +81,11 @@ Ah, that’s more like it. So let’s see which methods our greeter object
 responds to:
 
 {% highlight irb %}
-irb(main):041:0> g.respond_to?("name")
+irb(main):041:0> greeter.respond_to?("name")
 => false
-irb(main):042:0> g.respond_to?("say_hi")
+irb(main):042:0> greeter.respond_to?("say_hi")
 => true
-irb(main):043:0> g.respond_to?("to_s")
+irb(main):043:0> greeter.respond_to?("to_s")
 => true
 {% endhighlight %}
 
@@ -111,22 +111,22 @@ objects of that class. So, let’s create a new object and play with its
 `@name` property.
 
 {% highlight irb %}
-irb(main):047:0> g = Greeter.new("Andy")
+irb(main):047:0> greeter = Greeter.new("Andy")
 => #<Greeter:0x3c9b0 @name="Andy">
-irb(main):048:0> g.respond_to?("name")
+irb(main):048:0> greeter.respond_to?("name")
 => true
-irb(main):049:0> g.respond_to?("name=")
+irb(main):049:0> greeter.respond_to?("name=")
 => true
-irb(main):050:0> g.say_hi
+irb(main):050:0> greeter.say_hi
 Hi Andy!
 => nil
-irb(main):051:0> g.name="Betty"
+irb(main):051:0> greeter.name="Betty"
 => "Betty"
-irb(main):052:0> g
+irb(main):052:0> greeter
 => #<Greeter:0x3c9b0 @name="Betty">
-irb(main):053:0> g.name
+irb(main):053:0> greeter.name
 => "Betty"
-irb(main):054:0> g.say_hi
+irb(main):054:0> greeter.say_hi
 Hi Betty!
 => nil
 {% endhighlight %}
@@ -181,7 +181,6 @@ class MegaGreeter
       puts "Goodbye #{@names}.  Come back soon!"
     end
   end
-
 end
 
 
@@ -197,7 +196,7 @@ if __FILE__ == $0
 
   # Change the name to an array of names
   mg.names = ["Albert", "Brenda", "Charles",
-    "Dave", "Engelbert"]
+              "Dave", "Engelbert"]
   mg.say_hi
   mg.say_bye