consistent comments and parameter names

Author: mschuchard

src/interface/allocation.rs

@@ -35,20 +35,20 @@ pub async fn allocation(
 /// ```
 pub async fn allocations(
     client: &client::Client,
-    assignment_type_id: Option<enums::AssignmentType>,
-    member_id: Option<types::UUID>,
+    assignment_type: Option<enums::AssignmentType>,
+    member: Option<types::UUID>,
     start_date: Option<types::Date>,
     end_date: Option<types::Date>,
 ) -> Result<allocation::Allocations, Box<dyn std::error::Error>> {
     // initialize params
     let mut params = String::from("limit=100");
 
     // optional parameters for LIST
-    if let Some(assignment_type_id) = assignment_type_id {
-        write!(params, "&assignmentTypeId={}", assignment_type_id)?;
+    if let Some(assignment_type) = assignment_type {
+        write!(params, "&assignmentTypeId={}", assignment_type)?;
     }
-    if let Some(member_id) = member_id {
-        write!(params, "&memberId={}", member_id)?;
+    if let Some(member) = member {
+        write!(params, "&memberId={}", member)?;
     }
     if let Some(start_date) = start_date {
         write!(params, "&startOnBefore={}", start_date)?;

src/interface/cost.rs

@@ -31,17 +31,17 @@ pub async fn cost(
 /// ```
 pub async fn costs(
     client: &client::Client,
-    member_id: Option<types::UUID>,
+    member: Option<types::UUID>,
 ) -> Result<cost::Costs, Box<dyn std::error::Error>> {
     // initialize params
     let mut params = String::from("limit=100");
 
     // optional parameters for LIST
-    if let Some(member_id) = member_id {
-        write!(params, "&memberId={}", member_id)?;
+    if let Some(member) = member {
+        write!(params, "&memberId={}", member)?;
     }
 
-    // retrieve clients
+    // retrieve cost target periods
     Ok(client
         .read::<cost::Costs>("cost-periods", Some(&params))
         .await?)

src/interface/utilization.rs

@@ -31,17 +31,17 @@ pub async fn utilization(
 /// ```
 pub async fn utilizations(
     client: &client::Client,
-    member_id: Option<types::UUID>,
+    member: Option<types::UUID>,
 ) -> Result<utilization::Utilizations, Box<dyn std::error::Error>> {
     // initialize params
     let mut params = String::from("limit=100");
 
     // optional parameters for LIST
-    if let Some(member_id) = member_id {
-        write!(params, "&memberId={}", member_id)?;
+    if let Some(member) = member {
+        write!(params, "&memberId={}", member)?;
     }
 
-    // retrieve clients
+    // retrieve utilization target periods
     Ok(client
         .read::<utilization::Utilizations>("utilization-target-periods", Some(&params))
         .await?)