Add the docs and rename the command

README.md

@@ -232,6 +232,40 @@ end
 
 List of Recognized Events can be found [here](https://github.com/castle/castle-ruby/tree/master/lib/castle/events.rb) or in the [docs](https://docs.castle.io/api_reference/#list-of-recognized-events)
 
+## Device management
+
+This SDK allows issuing requests to [Castle's Device Management Endpoints](https://docs.castle.io/device_management_tool/). Use these endpoints for admin-level management of end-user devices (i.e., for an internal dashboard).
+
+Fetching device data, approving a device, reporting a device requires a valid `device_token`.
+
+```ruby
+# Get device data
+::Castle::API::GetDevice.call(device_token: device_token)
+# Approve a device
+::Castle::API::ApproveDevice.call(device_token: device_token)
+# Report a device
+::Castle::API::ReportDevice.call(device_token: device_token)
+```
+
+#### castle_device_reporting_worker.rb
+
+```ruby
+class CastleDeviceReportingWorker
+  include Sidekiq::Worker
+
+  def perform(device_token)
+    ::Castle::API::ReportDevice.call(device_token: device_token)
+  end
+end
+```
+
+Fetching available devices that belong to a given user requires a valid `user_id`.
+
+```ruby
+# Get user's devices data
+::Castle::API::GetDevicesForUser.call(user_id: user.id)
+```
+
 ## Impersonation mode
 
 https://castle.io/docs/impersonation_mode

lib/castle.rb

@@ -27,7 +27,7 @@
   castle/commands/approve_device
   castle/commands/authenticate
   castle/commands/get_device
-  castle/commands/get_devices
+  castle/commands/get_devices_for_user
   castle/commands/identify
   castle/commands/impersonate
   castle/commands/report_device
@@ -36,7 +36,7 @@
   castle/api/approve_device
   castle/api/authenticate
   castle/api/get_device
-  castle/api/get_devices
+  castle/api/get_devices_for_user
   castle/api/identify
   castle/api/impersonate
   castle/api/report_device

lib/castle/api/get_devices.rb → lib/castle/api/get_devices_for_user.rb

@@ -3,15 +3,15 @@
 module Castle
   module API
     # Sends GET users/#{user_id}/devices request
-    module GetDevices
+    module GetDevicesForUser
       class << self
         # @param options [Hash]
         # return [Hash]
         def call(options = {})
           options = Castle::Utils::DeepSymbolizeKeys.call(options || {})
 
           Castle::API.call(
-            Castle::Commands::GetDevices.build(options),
+            Castle::Commands::GetDevicesForUser.build(options),
             {},
             options[:http]
           )

lib/castle/commands/get_devices.rb → lib/castle/commands/get_devices_for_user.rb

@@ -3,7 +3,7 @@
 module Castle
   module Commands
     # Generated the payload for the GET users/#{user_id}/devices request
-    class GetDevices
+    class GetDevicesForUser
       class << self
         # @param options [Hash]
         # @return [Castle::Command]

spec/lib/castle/api/get_devices_spec.rb → spec/lib/castle/api/get_devices_for_user_spec.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-describe Castle::API::GetDevices do
+describe Castle::API::GetDevicesForUser do
   before do
     stub_request(:any, /api.castle.io/).with(
       basic_auth: ['', 'secret']

spec/lib/castle/commands/get_devices_spec.rb → spec/lib/castle/commands/get_devices_for_user_spec.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-describe Castle::Commands::GetDevices do
+describe Castle::Commands::GetDevicesForUser do
   subject(:instance) { described_class }
 
   let(:context) { {} }