Improve documentation for API.add_list_members

diff --git a/docs/api.rst b/docs/api.rst
index 1e969d86c9d5f82738bf727df1cc1a9267b9b624..a17e3955d372c28a38c4f2960885cc749cfa01b1 100644 (file)
--- a/docs/api.rst
+++ b/docs/api.rst
@@ -691,17 +691,17 @@ List Methods
    :param id: the ID of the user to add as a member
    :rtype: :class:`List` object
 
-.. method:: API.add_list_members(screen_name, user_id, slug, list_id, owner_id, owner_screen_name)
+.. method:: API.add_list_members(list_id/slug, screen_name/user_id, [owner_id/owner_screen_name])
 
    Add up to 100 members to a list. The authenticated user must own the list to be
    able to add members to it. Lists are limited to 5,000 members.
 
+   :param list_id: |list_id|
+   :param slug: |slug|
    :param screen_name: A comma separated list of screen names, up to 100 are allowed in a single request
    :param user_id: A comma separated list of user IDs, up to 100 are allowed in a single request
-   :param slug: |slug|
-   :param list_id: The numerical id of the list
-   :param owner_id: The user ID of the user who owns the list being requested by a slug
-   :param owner_screen_name: The screen name of the user who owns the list being requested by a slug
+   :param owner_id: |owner_id|
+   :param owner_screen_name: |owner_screen_name|
    :rtype: :class:`List` object
 
 .. method:: API.remove_list_member(slug, id)