Skip to content

Why don't we have a section in the docs under storage called Acl ? #573

Description

@jgeewax

Seems that http://googlecloudplatform.github.io/gcloud-node/#/docs/v0.14.0/storage/acl is generated, but we don't have an item in the sidebar. Is that because we inlined the ACL-related methods into the Bucket/File as whatever.acl.method ?

Activity

  1. added this to the Core Future milestone on May 9, 2015
  2. ryanseys commented on May 11, 2015

    @ryanseys
    Contributor

    Yep. We don't expose Acl directly to the user, only through Bucket and File, which use this shared Acl class that you're talking about here.

  3. jgeewax commented on May 11, 2015

    @jgeewax
    ContributorAuthor

    That makes sense.

    So should we expose this to the user? Or is it better left as a hidden mix-in style class?

  4. stephenplusplus commented on May 14, 2015

    @stephenplusplus
    Contributor

    I only like keeping that page hidden because I worry it would be confusing for developers to differentiate between the file / bucket scenarios, then the default Bucket object. Keeping them doc'd on their module pages lets us have more control how the concepts are presented to the user.

    But if you guys think it's more helpful having the ACL page as well, I'm cool with it.

  5. changed the title [-]Why don't we have a section int he docs under storage called Acl ?[/-] [+]Why don't we have a section in the docs under storage called Acl ?[/+] on May 14, 2015
  6. jgeewax commented on May 14, 2015

    @jgeewax
    ContributorAuthor

    I have no preference at all - I think we're fine as is...

  7. added a commit that references this issue on Sep 15, 2022
  8. 20 remaining items

  9. added a commit that references this issue on Jan 21, 2026
  10. added a commit that references this issue on Feb 2, 2026
  11. added a commit that references this issue on Mar 27, 2026
  12. added a commit that references this issue on May 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

type: questionRequest for information or clarification. Not an issue.

Type

No type

Projects

No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions