task_searches.rb in checkoff-0.36.0

- old
+ new

@@ -12,11 +12,11 @@
 require 'asana/resource_includes/collection'
 require 'asana/resource_includes/response_helper'
 
 require 'checkoff/internal/search_url'
 
-# https://developers.asana.com/docs/task-searches
+# https://developers.asana.com/reference/searchtasksforworkspace
 module Checkoff
   # Run task searches against the Asana API
   class TaskSearches
     MINUTE = 60
     HOUR = MINUTE * 60
@@ -41,9 +41,13 @@
       @client = client
       @search_url_parser = search_url_parser
       @asana_resources_collection_class = asana_resources_collection_class
     end
 
+    # @param [String] workspace_name
+    # @param [String] url
+    # @param [Array<String>] extra_fields
+    # @return [Array<Asana::Resources::Task>]
     def task_search(workspace_name, url, extra_fields: [])
       workspace = workspaces.workspace_or_raise(workspace_name)
       api_params, task_selector = @search_url_parser.convert_params(url)
       path = "/workspaces/#{workspace.gid}/tasks/search"
       options = calculate_api_options(extra_fields)