service.rb in twilio-ruby-5.0.0.rc25

- old
+ new

@@ -306,12 +306,15 @@
             )
           end
 
           ##
           # Access the bindings
-          # @return [BindingList] BindingList
+          # @return [BindingList] if a(n) BindingList object was created.
+          # @return [BindingContext] if a(n) BindingContext object was created.
           def bindings(sid=:unset)
+            raise ArgumentError, 'sid cannot be nil' if sid.nil?
+
             if sid != :unset
               return BindingContext.new(
                   @version,
                   @solution[:sid],
                   sid,
@@ -328,11 +331,12 @@
             @bindings
           end
 
           ##
           # Access the notifications
-          # @return [NotificationList] NotificationList
+          # @return [NotificationList] if a(n) NotificationList object was created.
+          # @return [NotificationContext] if a(n) NotificationContext object was created.
           def notifications
             unless @notifications
               @notifications = NotificationList.new(
                   @version,
                   service_sid: @solution[:sid],
@@ -342,12 +346,15 @@
             @notifications
           end
 
           ##
           # Access the users
-          # @return [UserList] UserList
+          # @return [UserList] if a(n) UserList object was created.
+          # @return [UserContext] if a(n) UserContext object was created.
           def users(identity=:unset)
+            raise ArgumentError, 'identity cannot be nil' if identity.nil?
+
             if identity != :unset
               return UserContext.new(
                   @version,
                   @solution[:sid],
                   identity,
@@ -364,10 +371,11 @@
             @users
           end
 
           ##
           # Access the segments
-          # @return [SegmentList] SegmentList
+          # @return [SegmentList] if a(n) SegmentList object was created.
+          # @return [SegmentContext] if a(n) SegmentContext object was created.
           def segments
             unless @segments
               @segments = SegmentList.new(
                   @version,
                   service_sid: @solution[:sid],
\ No newline at end of file