[DOC]Refactor Access Rules APIs

[OpenStack Infra]

https://review.openstack.org/369668
Dear bug triager. This bug was created since a commit was marked with DOCIMPACT.
Your project "openstack/manila" is set up so that we directly report the documentation bugs against it. If this needs changing, the docimpact-group option needs to be added for the project. You can ask the OpenStack infra team (#openstack-infra on freenode) for help if you need to.

commit 64a73b1419953bc4fbae5c1a339ad036468d54ab
Author: Goutham Pacha Ravi <email address hidden>
Date: Tue Aug 23 15:33:21 2016 -0400

    Refactor Access Rules APIs

    - Pull up policy check to beginning of the APIs.
    - Avoid making access rules changes when one or
      more instances of the share are in an invalid state.
    - Add back the per rule share instance access status.
      This restoration provides better visibility for which
      rules were applied successfully.
    - Remove 'updating' and 'updating_multiple' as valid
      states for the share instance access rules status.
    - Deprecate the access rule state 'new' in favor of
      'queued_to_apply' and the share instance access rules
      status 'out_of_sync' in favor of 'syncing'.

    In a new API micro-version:
    - Allow access rule changes irrespective of the share's
       access_rules_status.
    - Expose new access rule states and share's
      access_rules_status values.

    Access rules for each share instance now transition
    from 'queued_to_apply' to 'applying' to 'active' or 'error';
    and from 'active', 'queued_to_apply', 'applying' or 'error'
    to 'queued_to_deny' to 'denying' to 'deleted'.

    APIImpact
    DocImpact

    Partially-implements: bp fix-and-improve-access-rules
    Co-Authored-By: Mike Rooney <email address hidden>
    Change-Id: Ic25e63215b5ba723cbc8cab7c51789c698e76f28

[Tom Barron (tpb)]

This refactor from 2016 is quite old. Significant additional refactors and cleanups to access-list api as well as doc updates have been done since so we don't need this DOCIMPACT tracker anymore.