RPM Support

We have API docs:

http://docs.pulpproject.org/dev-guide/integration/rest-api/repo/cud.html#update-a-repository
http://docs.pulpproject.org/dev-guide/integration/rest-api/repo/cud.html#associate-a-distributor-with-a-repository

Do those suffice? Plugins should specify what options are available, and the API docs should specify how to use the API. Perhaps we can make that distinction more clear.

We have API docs:

http://docs.pulpproject.org/dev-guide/integration/rest-api/repo/cud.html#update-a-repository
http://docs.pulpproject.org/dev-guide/integration/rest-api/repo/cud.html#associate-a-distributor-with-a-repository

Do those suffice?

No, those links do not suffice.

Yes, the plugin documentation explains which options are available and the semantics of those options. However, neither the plugin documentation nor the API documentation explains how to structure those options.

For example, let's say that I want to set the content_units_only option to "true" when creating an RPM rsync distributor. Is this the correct way to specify the option?

{
    "distributor_id": "my_rpm_rsync_distributor",
    "distributor_type_id": "rpm_rsync_distributor",
    "distributor_config": {
        "remote": {
            "auth_type": "publickey",
            "ssh_user": "foo",
            "ssh_identity_file": "/home/user/.ssh/id_rsa",
            "host": "192.168.121.1",
            "root": "/home/foo/pulp_root_dir",
            "content_units_only": true
        },
        "predistributor_id": "yum_distributor"
    }
}

Or is this the correct way to specify the option?

{
    "distributor_id": "my_rpm_rsync_distributor",
    "distributor_type_id": "rpm_rsync_distributor",
    "distributor_config": {
        "remote": {
            "auth_type": "publickey",
            "ssh_user": "foo",
            "ssh_identity_file": "/home/user/.ssh/id_rsa",
            "host": "192.168.121.1",
            "root": "/home/foo/pulp_root_dir" 
        },
        "predistributor_id": "yum_distributor",
        "content_units_only": true
    }
}

Or is this the correct way to specify the option?

{
    "distributor_id": "my_rpm_rsync_distributor",
    "distributor_type_id": "rpm_rsync_distributor",
    "distributor_config": {
        "remote": {
            "auth_type": "publickey",
            "ssh_user": "foo",
            "ssh_identity_file": "/home/user/.ssh/id_rsa",
            "host": "192.168.121.1",
            "root": "/home/foo/pulp_root_dir" 
        },
        "predistributor_id": "yum_distributor"
    },
    "content_units_only": true
}

Neither the plugin docs nor the API docs explain how I should structure my request to the server.