Refreshed docs, now with repeated params
diff --git a/docs/dyn/buzz.v1.comments.html b/docs/dyn/buzz.v1.comments.html
index d965aff..8a017aa 100644
--- a/docs/dyn/buzz.v1.comments.html
+++ b/docs/dyn/buzz.v1.comments.html
@@ -17,52 +17,72 @@
 <dl><dt><a name="Resource-delete"><strong>delete</strong></a> = method(self, **kwargs)</dt><dd><tt>Delete&nbsp;a&nbsp;comment<br>
 &nbsp;<br>
 Args:<br>
-&nbsp;&nbsp;commentId:&nbsp;ID&nbsp;of&nbsp;the&nbsp;comment&nbsp;being&nbsp;referenced.&nbsp;(required)<br>
-&nbsp;&nbsp;alt:&nbsp;Specifies&nbsp;an&nbsp;alternative&nbsp;representation&nbsp;type.<br>
-&nbsp;&nbsp;postId:&nbsp;ID&nbsp;of&nbsp;the&nbsp;activity&nbsp;for&nbsp;which&nbsp;to&nbsp;delete&nbsp;the&nbsp;comment.&nbsp;(required)<br>
-&nbsp;&nbsp;userId:&nbsp;ID&nbsp;of&nbsp;the&nbsp;user&nbsp;being&nbsp;referenced.&nbsp;(required)<br>
-&nbsp;&nbsp;hl:&nbsp;Language&nbsp;code&nbsp;to&nbsp;limit&nbsp;language&nbsp;results.</tt></dd></dl>
+&nbsp;&nbsp;userId:&nbsp;string,&nbsp;ID&nbsp;of&nbsp;the&nbsp;user&nbsp;being&nbsp;referenced.&nbsp;(required)<br>
+&nbsp;&nbsp;hl:&nbsp;string,&nbsp;Language&nbsp;code&nbsp;to&nbsp;limit&nbsp;language&nbsp;results.<br>
+&nbsp;&nbsp;commentId:&nbsp;string,&nbsp;ID&nbsp;of&nbsp;the&nbsp;comment&nbsp;being&nbsp;referenced.&nbsp;(required)<br>
+&nbsp;&nbsp;alt:&nbsp;string,&nbsp;Specifies&nbsp;an&nbsp;alternative&nbsp;representation&nbsp;type.<br>
+&nbsp;&nbsp;&nbsp;&nbsp;Allowed&nbsp;values<br>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;atom&nbsp;-&nbsp;Use&nbsp;Atom&nbsp;XML&nbsp;format<br>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;json&nbsp;-&nbsp;Use&nbsp;JSON&nbsp;format<br>
+&nbsp;&nbsp;postId:&nbsp;string,&nbsp;ID&nbsp;of&nbsp;the&nbsp;activity&nbsp;for&nbsp;which&nbsp;to&nbsp;delete&nbsp;the&nbsp;comment.&nbsp;(required)</tt></dd></dl>
 
 <dl><dt><a name="Resource-get"><strong>get</strong></a> = method(self, **kwargs)</dt><dd><tt>Get&nbsp;a&nbsp;comment<br>
 &nbsp;<br>
 Args:<br>
-&nbsp;&nbsp;commentId:&nbsp;ID&nbsp;of&nbsp;the&nbsp;comment&nbsp;being&nbsp;referenced.&nbsp;(required)<br>
-&nbsp;&nbsp;alt:&nbsp;Specifies&nbsp;an&nbsp;alternative&nbsp;representation&nbsp;type.<br>
-&nbsp;&nbsp;postId:&nbsp;ID&nbsp;of&nbsp;the&nbsp;activity&nbsp;for&nbsp;which&nbsp;to&nbsp;get&nbsp;comments.&nbsp;(required)<br>
-&nbsp;&nbsp;userId:&nbsp;ID&nbsp;of&nbsp;the&nbsp;user&nbsp;being&nbsp;referenced.&nbsp;(required)<br>
-&nbsp;&nbsp;hl:&nbsp;Language&nbsp;code&nbsp;to&nbsp;limit&nbsp;language&nbsp;results.</tt></dd></dl>
+&nbsp;&nbsp;userId:&nbsp;string,&nbsp;ID&nbsp;of&nbsp;the&nbsp;user&nbsp;being&nbsp;referenced.&nbsp;(required)<br>
+&nbsp;&nbsp;hl:&nbsp;string,&nbsp;Language&nbsp;code&nbsp;to&nbsp;limit&nbsp;language&nbsp;results.<br>
+&nbsp;&nbsp;commentId:&nbsp;string,&nbsp;ID&nbsp;of&nbsp;the&nbsp;comment&nbsp;being&nbsp;referenced.&nbsp;(required)<br>
+&nbsp;&nbsp;alt:&nbsp;string,&nbsp;Specifies&nbsp;an&nbsp;alternative&nbsp;representation&nbsp;type.<br>
+&nbsp;&nbsp;&nbsp;&nbsp;Allowed&nbsp;values<br>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;atom&nbsp;-&nbsp;Use&nbsp;Atom&nbsp;XML&nbsp;format<br>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;json&nbsp;-&nbsp;Use&nbsp;JSON&nbsp;format<br>
+&nbsp;&nbsp;postId:&nbsp;string,&nbsp;ID&nbsp;of&nbsp;the&nbsp;activity&nbsp;for&nbsp;which&nbsp;to&nbsp;get&nbsp;comments.&nbsp;(required)</tt></dd></dl>
 
 <dl><dt><a name="Resource-insert"><strong>insert</strong></a> = method(self, **kwargs)</dt><dd><tt>Create&nbsp;a&nbsp;comment<br>
 &nbsp;<br>
 Args:<br>
-&nbsp;&nbsp;body:&nbsp;The&nbsp;request&nbsp;body.<br>
-&nbsp;&nbsp;alt:&nbsp;Specifies&nbsp;an&nbsp;alternative&nbsp;representation&nbsp;type.<br>
-&nbsp;&nbsp;postId:&nbsp;ID&nbsp;of&nbsp;the&nbsp;activity&nbsp;on&nbsp;which&nbsp;to&nbsp;comment.&nbsp;(required)<br>
-&nbsp;&nbsp;userId:&nbsp;ID&nbsp;of&nbsp;the&nbsp;user&nbsp;on&nbsp;whose&nbsp;behalf&nbsp;to&nbsp;comment.&nbsp;(required)<br>
-&nbsp;&nbsp;hl:&nbsp;Language&nbsp;code&nbsp;to&nbsp;limit&nbsp;language&nbsp;results.</tt></dd></dl>
+&nbsp;&nbsp;body:&nbsp;object,&nbsp;The&nbsp;request&nbsp;body.<br>
+&nbsp;&nbsp;userId:&nbsp;string,&nbsp;ID&nbsp;of&nbsp;the&nbsp;user&nbsp;on&nbsp;whose&nbsp;behalf&nbsp;to&nbsp;comment.&nbsp;(required)<br>
+&nbsp;&nbsp;hl:&nbsp;string,&nbsp;Language&nbsp;code&nbsp;to&nbsp;limit&nbsp;language&nbsp;results.<br>
+&nbsp;&nbsp;alt:&nbsp;string,&nbsp;Specifies&nbsp;an&nbsp;alternative&nbsp;representation&nbsp;type.<br>
+&nbsp;&nbsp;&nbsp;&nbsp;Allowed&nbsp;values<br>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;atom&nbsp;-&nbsp;Use&nbsp;Atom&nbsp;XML&nbsp;format<br>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;json&nbsp;-&nbsp;Use&nbsp;JSON&nbsp;format<br>
+&nbsp;&nbsp;postId:&nbsp;string,&nbsp;ID&nbsp;of&nbsp;the&nbsp;activity&nbsp;on&nbsp;which&nbsp;to&nbsp;comment.&nbsp;(required)</tt></dd></dl>
 
 <dl><dt><a name="Resource-list"><strong>list</strong></a> = method(self, **kwargs)</dt><dd><tt>List&nbsp;comments<br>
 &nbsp;<br>
 Args:<br>
-&nbsp;&nbsp;c:&nbsp;A&nbsp;continuation&nbsp;token&nbsp;that&nbsp;allows&nbsp;pagination.<br>
-&nbsp;&nbsp;userId:&nbsp;ID&nbsp;of&nbsp;the&nbsp;user&nbsp;for&nbsp;whose&nbsp;post&nbsp;to&nbsp;get&nbsp;comments.&nbsp;(required)<br>
-&nbsp;&nbsp;max_results:&nbsp;Maximum&nbsp;number&nbsp;of&nbsp;results&nbsp;to&nbsp;include.<br>
-&nbsp;&nbsp;hl:&nbsp;Language&nbsp;code&nbsp;to&nbsp;limit&nbsp;language&nbsp;results.<br>
-&nbsp;&nbsp;scope:&nbsp;The&nbsp;collection&nbsp;to&nbsp;which&nbsp;the&nbsp;activity&nbsp;belongs.&nbsp;(required)<br>
-&nbsp;&nbsp;alt:&nbsp;Specifies&nbsp;an&nbsp;alternative&nbsp;representation&nbsp;type.<br>
-&nbsp;&nbsp;postId:&nbsp;ID&nbsp;of&nbsp;the&nbsp;activity&nbsp;for&nbsp;which&nbsp;to&nbsp;get&nbsp;comments.&nbsp;(required)</tt></dd></dl>
+&nbsp;&nbsp;c:&nbsp;string,&nbsp;A&nbsp;continuation&nbsp;token&nbsp;that&nbsp;allows&nbsp;pagination.<br>
+&nbsp;&nbsp;userId:&nbsp;string,&nbsp;ID&nbsp;of&nbsp;the&nbsp;user&nbsp;for&nbsp;whose&nbsp;post&nbsp;to&nbsp;get&nbsp;comments.&nbsp;(required)<br>
+&nbsp;&nbsp;max_results:&nbsp;integer,&nbsp;Maximum&nbsp;number&nbsp;of&nbsp;results&nbsp;to&nbsp;include.<br>
+&nbsp;&nbsp;hl:&nbsp;string,&nbsp;Language&nbsp;code&nbsp;to&nbsp;limit&nbsp;language&nbsp;results.<br>
+&nbsp;&nbsp;scope:&nbsp;string,&nbsp;The&nbsp;collection&nbsp;to&nbsp;which&nbsp;the&nbsp;activity&nbsp;belongs.&nbsp;(required)<br>
+&nbsp;&nbsp;&nbsp;&nbsp;Allowed&nbsp;values<br>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;@self&nbsp;-&nbsp;Activities&nbsp;posted&nbsp;by&nbsp;the&nbsp;user.<br>
+&nbsp;&nbsp;alt:&nbsp;string,&nbsp;Specifies&nbsp;an&nbsp;alternative&nbsp;representation&nbsp;type.<br>
+&nbsp;&nbsp;&nbsp;&nbsp;Allowed&nbsp;values<br>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;atom&nbsp;-&nbsp;Use&nbsp;Atom&nbsp;XML&nbsp;format<br>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;json&nbsp;-&nbsp;Use&nbsp;JSON&nbsp;format<br>
+&nbsp;&nbsp;postId:&nbsp;string,&nbsp;ID&nbsp;of&nbsp;the&nbsp;activity&nbsp;for&nbsp;which&nbsp;to&nbsp;get&nbsp;comments.&nbsp;(required)</tt></dd></dl>
 
 <dl><dt><a name="Resource-update"><strong>update</strong></a> = method(self, **kwargs)</dt><dd><tt>Update&nbsp;a&nbsp;comment<br>
 &nbsp;<br>
 Args:<br>
-&nbsp;&nbsp;body:&nbsp;The&nbsp;request&nbsp;body.<br>
-&nbsp;&nbsp;userId:&nbsp;ID&nbsp;of&nbsp;the&nbsp;user&nbsp;being&nbsp;referenced.&nbsp;(required)<br>
-&nbsp;&nbsp;abuseType:&nbsp;A&nbsp;parameter<br>
-&nbsp;&nbsp;hl:&nbsp;Language&nbsp;code&nbsp;to&nbsp;limit&nbsp;language&nbsp;results.<br>
-&nbsp;&nbsp;commentId:&nbsp;ID&nbsp;of&nbsp;the&nbsp;comment&nbsp;being&nbsp;referenced.&nbsp;(required)<br>
-&nbsp;&nbsp;scope:&nbsp;The&nbsp;collection&nbsp;to&nbsp;which&nbsp;the&nbsp;activity&nbsp;belongs.&nbsp;(required)<br>
-&nbsp;&nbsp;alt:&nbsp;Specifies&nbsp;an&nbsp;alternative&nbsp;representation&nbsp;type.<br>
-&nbsp;&nbsp;postId:&nbsp;ID&nbsp;of&nbsp;the&nbsp;activity&nbsp;for&nbsp;which&nbsp;to&nbsp;update&nbsp;the&nbsp;comment.&nbsp;(required)</tt></dd></dl>
+&nbsp;&nbsp;body:&nbsp;object,&nbsp;The&nbsp;request&nbsp;body.<br>
+&nbsp;&nbsp;userId:&nbsp;string,&nbsp;ID&nbsp;of&nbsp;the&nbsp;user&nbsp;being&nbsp;referenced.&nbsp;(required)<br>
+&nbsp;&nbsp;abuseType:&nbsp;string,&nbsp;A&nbsp;parameter<br>
+&nbsp;&nbsp;hl:&nbsp;string,&nbsp;Language&nbsp;code&nbsp;to&nbsp;limit&nbsp;language&nbsp;results.<br>
+&nbsp;&nbsp;commentId:&nbsp;string,&nbsp;ID&nbsp;of&nbsp;the&nbsp;comment&nbsp;being&nbsp;referenced.&nbsp;(required)<br>
+&nbsp;&nbsp;scope:&nbsp;string,&nbsp;The&nbsp;collection&nbsp;to&nbsp;which&nbsp;the&nbsp;activity&nbsp;belongs.&nbsp;(required)<br>
+&nbsp;&nbsp;&nbsp;&nbsp;Allowed&nbsp;values<br>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;@abuse&nbsp;-&nbsp;Comments&nbsp;reported&nbsp;by&nbsp;the&nbsp;user.<br>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;@self&nbsp;-&nbsp;Comments&nbsp;posted&nbsp;by&nbsp;the&nbsp;user.<br>
+&nbsp;&nbsp;alt:&nbsp;string,&nbsp;Specifies&nbsp;an&nbsp;alternative&nbsp;representation&nbsp;type.<br>
+&nbsp;&nbsp;&nbsp;&nbsp;Allowed&nbsp;values<br>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;atom&nbsp;-&nbsp;Use&nbsp;Atom&nbsp;XML&nbsp;format<br>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;json&nbsp;-&nbsp;Use&nbsp;JSON&nbsp;format<br>
+&nbsp;&nbsp;postId:&nbsp;string,&nbsp;ID&nbsp;of&nbsp;the&nbsp;activity&nbsp;for&nbsp;which&nbsp;to&nbsp;update&nbsp;the&nbsp;comment.&nbsp;(required)</tt></dd></dl>
 
 <hr>
 Data descriptors defined here:<br>