docs(scopes): scope docs for method builders

src/mako/lib/mbuild.mako

@@ -57,6 +57,21 @@ ${m.description | rust_doc_comment}
 % if part_desc:
 ${part_desc | rust_doc_comment}
 ///
+% if m.get('scopes'):
+/// # Scopes
+///
+/// You will need authorization for \
+% if len(m.scopes) > 1:
+at least one of the following scopes to make a valid call:
+/// 
+% for s in m.scopes:
+/// * *${s}*
+% endfor
+% else:
+the *${m.scopes[0]}* scope to make a valid call.
+% endif
+% endif
+///
 % endif
 /// # Example
 ///

src/mako/lib/util.py

@@ -406,6 +406,8 @@ def organize_params(params, request_value):
     # end for each property
     return required_props, optional_props, part_prop
 
+# returns method parameters based on whether we can make uploads
+
 # schemas, context, method(dict), 'request'|'response', request_prop_name -> (params, request_value|None)
 def build_all_params(schemas, c, m, n, npn):
     request_value = method_io(schemas, c, m, n)