chore: update sphinx arrangement to remove duplicate entries on cloudsite

[cojenco]

As part of the docs revamp, remove duplicate entries in python/docs/reference/storage

For example, module Bucket appears both in https://cloud.google.com/python/docs/reference/storage/latest/buckets and https://cloud.google.com/python/docs/reference/storage/latest/google.cloud.storage.bucket

Collaborated with dandhlee@ on rearranging the sphinx arrangement. This PR

• removes this extra entries while keeping the rest of the documentation intact
• revises sphinx tags that are incorrectly used as region tags
• clean up ACL docstrings

Verified that the documentation generated looks correct. Follow-up work tracked in internal doc.

Fixes internal b/232410558

[snippet-bot]

Here is the summary of changes.

You are about to delete 41 region tags.

• docs/snippets.py:37, tag storage_get_started
• docs/snippets.py:56, tag client_bucket_acl
• docs/snippets.py:63, tag acl_user_settings
• docs/snippets.py:68, tag acl_save
• docs/snippets.py:72, tag acl_revoke_write
• docs/snippets.py:77, tag acl_save_bucket
• docs/snippets.py:81, tag acl_print
• docs/snippets.py:89, tag download_to_file
• docs/snippets.py:106, tag upload_from_file
• docs/snippets.py:124, tag get_blob
• docs/snippets.py:138, tag delete_blob
• docs/snippets.py:154, tag delete_blobs
• docs/snippets.py:164, tag configure_website
• docs/snippets.py:170, tag make_public
• docs/snippets.py:181, tag get_bucket
• docs/snippets.py:192, tag add_lifecycle_delete_rule
• docs/snippets.py:202, tag add_lifecycle_set_storage_class_rule
• docs/snippets.py:216, tag lookup_bucket
• docs/snippets.py:232, tag create_bucket
• docs/snippets.py:243, tag list_buckets
• docs/snippets.py:255, tag policy_document
• google/cloud/storage/init.py:20, tag storage_get_started
• google/cloud/storage/acl.py:22, tag client_bucket_acl
• google/cloud/storage/acl.py:54, tag acl_user_settings
• google/cloud/storage/acl.py:62, tag acl_save
• google/cloud/storage/acl.py:71, tag acl_save_bucket
• google/cloud/storage/acl.py:79, tag acl_print
• google/cloud/storage/blob.py:1044, tag download_to_file
• google/cloud/storage/blob.py:2441, tag upload_from_file
• google/cloud/storage/bucket.py:1176, tag get_blob
• google/cloud/storage/bucket.py:1595, tag delete_blob
• google/cloud/storage/bucket.py:1643, tag delete_blobs
• google/cloud/storage/bucket.py:2314, tag add_lifecycle_delete_rule
• google/cloud/storage/bucket.py:2332, tag add_lifecycle_set_storage_class_rule
• google/cloud/storage/bucket.py:2692, tag configure_website
• google/cloud/storage/bucket.py:2699, tag make_public
• google/cloud/storage/bucket.py:3115, tag policy_document
• google/cloud/storage/client.py:764, tag get_bucket
• google/cloud/storage/client.py:805, tag lookup_bucket
• google/cloud/storage/client.py:919, tag create_bucket
• google/cloud/storage/client.py:1336, tag list_buckets

---

This comment is generated by snippet-bot.
If you find problems with this result, please file an issue at:
https://github.com/googleapis/repo-automation-bots/issues.
To update this comment, add snippet-bot:force-run label or use the checkbox below:

• Refresh this comment

[dandhlee]

Cloud RAD likely does not have support for .. literalinclude (I think I remember this was an issue in other libraries too) but we can deal with it later. LGTM! 🚀