Well, I'll say that my perspective was as a complete newb using Amazon's S3 service. Prior to last Friday I hadn't messed with any of their stuff. I also had my hosting provider upgrade my OpenBD server from 1.3 to 1.4 solely to make use of the Amazon S3 functionality of OpenBD 1.4. So yeah, I got a full dose of new stuff all around. You may be entirely correct in that the OpenBD docs used the same terms...and perhaps my ire ought to have been directed at Amazon's docs then for their inability to use another word other than "key" to describe pretty much everything they expect the dev to provide to connect.
That said, from the OpenBD end, it was still confusing that the only thing on the OpenBD manual entry for that particular function for the key attribute was this: "key Full key" Not all that descriptive or helpful. :) As an aside, I've created an AmazonS3 category (http:// wiki.openbluedragon.org/wiki/index.php/Category:AmazonS3) as well as an entry for the AmazonS3SetAcl() function (http:// wiki.openbluedragon.org/wiki/index.php/AmazonS3SetAcl%28%29) but I don't know how to tie the category to Amazon or the function to the category. Tell me how and I'll be happy to do so. Craig On Mar 2, 5:52 pm, "Nitai @ Razuna" <[email protected]> wrote: > Hi, > > While I "sort off" understand your frustration you also have to > understand that OpenBD simply adopted the same terms that Amazon S3 is > using. In other words, if you look up the documentation of S3 then you > will see that they are talking about "key", "secret key", etc. > > Seeing it in the light of Amazon S3 terms the OpenBD wiki docs make a > lot of sense. > > But, yes, documentation needs improvement and any help is very much > appreciated. > > Kind Regards, > Nitai > > On Wed, Mar 2, 2011 at 11:19 PM, Craig328 <[email protected]> wrote: > > Okay, after much profanity and hair pulling (my own) I finally figured > > out what was wrong. The OpenBD documentation for that function REALLY > > needs to define what they mean by "key" as in the attribute value > > you're expected to pass in. Once you figure it out, it seems really > > obvious but for crissake, the word "key" is used all over the friggin' > > place between Amazon and the OpenBD documentation. Nowhere did it say > > that in the case of this function, "key" means "the bucket's folder/ > > filename". Once you try THAT, oh hey look, it works. The folder/ > > filename is NOT a key...at least not when you're juggling an Amazon > > Access Key with an Access Key ID and a Secret Access Key and then the > > OpenBD function that deals with the Amazon S3 service calls the > > function parameter a "key" as well...when it's clearly not a key. > > -- > See for yourself how easy it is to manage files today. Join the revolution! > > Razuna SaaS On-Demand - Hosted Digital Asset Management > Solutionhttp://www.razuna.com/ > > Razuna - Open Source Digital Asset Managementhttp://www.razuna.org/ > > Follow us on Twitterhttp://twitter.com/razunahq -- official tag/function reference: http://openbd.org/manual/ mailing list - http://groups.google.com/group/openbd?hl=en
