Added som yard documentation to the duck typing example

.gitignore

@@ -1 +1,2 @@
 doc
+.yardoc

TODO

@@ -15,3 +15,5 @@
 - Explain attr_accessor
 - for file in $(find lib -iname '*.rb'); do ruby -Ilib $file; done
 - Enumerating strings with String#enum_for(:each_char|:each_byte|:each_line)
+- Change from Rdoc to Yard
+- Document duck_typing.rb with Yard

lib/duck_typing.rb

@@ -42,11 +42,14 @@ def off
 end
 
 class Thermostat
-  # Here we should document the protocol that we expect
-  # the furnace object to conform to. Note that we could add assertions
-  # in the code here (by using respond_to?) to try to ensure that the furnace object has
-  # the methods that we expect. In practice though, such assertions would add little value.
+  # Creates a new Thermostat object
+  #
+  # @param [#on, #off] furnace on/off device that the thermostat will control
   def initialize(furnace)
+    # Note that we could add assertions
+    # in the code here (by using respond_to?) to try to ensure that the furnace object has
+    # the methods that we expect. In practice though, such assertions would probably
+    # add little value.
     @furnace = furnace
   end
 
@@ -79,8 +82,9 @@ def run
 #  possibly more efficient way to transport the response. The Body commonly is an
 #  Array of Strings, the application instance itself, or a File-like object."
 #
-# Note how the Rack protocol is fairly strict and well specified and yet allows for a
-# lot of flexibility in what classes and objects you use.
+# Note how the Rack protocol is strict and well specified. The protocol is also quite
+# narrow and it helps minimize the dependency between the webserver and the application.
+# The protocol thus allows for a lot of flexibility in what classes and objects you use.
 #
 # Here is an example of a simple Rack application.
 

resources.rdoc

@@ -16,6 +16,8 @@ Freiburg Course
 * {Duck Typing in Practice (1 of 2)}[http://blog.rubybestpractices.com/posts/gregory/046-issue-14-duck-typing.html]
 * {Duck Typing in Practice (2 of 2)}[http://blog.rubybestpractices.com/posts/gregory/047-issue-15-duck-typing-2.html]
 
+* {What's Missing from TomDoc}[http://gnuu.org/2010/05/12/whats-missing-from-tomdoc]
+
 * {Ruby: to_s vs. to_str}[http://briancarper.net/blog/98/]
 
 Interviews with Matz