Use docstrings

Author: richardwang1124

gems/smithy/lib/smithy/templates/client/waiters.erb

@@ -14,7 +14,9 @@ module <%= module_name %>
 <% end -%>
     # @api private
     #
-    # <%= waiter.documentation %>
+<% waiter.docstrings.each do |docstring| -%>
+    # <%= docstring %>
+<% end -%>
     #
     class <%= waiter.name %>
       def initialize(options = {})

gems/smithy/lib/smithy/views/client/waiters.rb

@@ -50,6 +50,10 @@ def initialize(operation, name, waiter)
 
           attr_reader :operation_name, :name, :documentation, :acceptors, :min_delay, :max_delay, :deprecated
 
+          def docstrings
+            @documentation.split("\n")
+          end
+
           def formatted_acceptors(acceptors)
             acceptors.each { |acceptor| preprocess_acceptor(acceptor) }