Comment 4 for bug 1657498

Reviewed: https://review.openstack.org/427898
Committed: https://git.openstack.org/cgit/openstack/python-openstacksdk/commit/?id=e97a7550467ccf2bcd69bec57025c2b1d1ce615d
Submitter: Jenkins
Branch: master

commit e97a7550467ccf2bcd69bec57025c2b1d1ce615d
Author: Brian Curtin <email address hidden>
Date: Wed Feb 1 15:00:34 2017 -0500

    Adjust some proxy method names in cluster

    In auditing our proxy method names heading into the 1.0 release,
    where we'll need to be more careful about backwards compatibility,
    some names in the cluster proxy use structures that are different than
    we're using both around the other services and also within cluster
    itself. We've converged on several naming formats for add/remove,
    attach/detach, and several other grammar styles when naming operations
    that are done on a certain resource.

    This change introduces a deprecation decorator using the `deprecation`
    library, which was recently added to global-requirements. This is also
    the first change of several in the auditing process, just going
    alphabetical order through the services.

    The plan with these is that they're marked for deprecation in the
    next release (0.9.14), both here in the code and in the documentation
    via the deprecation library's ability to modify the docstring, which
    then shows up in our built documentation. In the meantime, we should
    help any users we know of—in this case we have cluster developers on
    this project—in updating calling code to use the newer format before
    1.0 happens.

    The following deprecations were made:
    * cluster_add_nodes -> add_nodes_to_cluster
    * cluster_del_nodes -> remove_nodes_from_cluster
    * cluster_replace_nodes -> replace_nodes_in_cluster
    * cluster_scale_out -> scale_out_cluster
    * cluster_scale_in -> scale_in_cluster
    * cluster_attach_policy -> attach_policy_to_cluster
    * cluster_detach_policy -> detach_policy_from_cluster
    * cluster_update_policy -> update_cluster_policy
    * cluster_operation -> perform_operation_on_cluster
    * node_operation -> perform_operation_on_node

    Partial-Bug: 1657498

    Change-Id: I3df0494f9ec0097aee7d47e05fb42094439bc4a4