jclouds-notifications mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Roman Coedo <notificati...@github.com>
Subject Re: [jclouds-labs-aws] JCLOUDS-457: Add README.md (#54)
Date Mon, 04 Aug 2014 09:34:09 GMT
> The main reason I was suggesting a Getting Started Guide rather than a README is that
most of the READMEs for APIs and providers are very stubby and/or not very useful, and the
result is that users are simply unlikely to look there.

I agree with this, maybe this is something we need to improve?

> Once I've had a chance to review the content, I'll also perhaps understand better why
you feel it wouldn't fit there ;-) In that case, perhaps a longer Javadoc for GlacierClient
and/or GlacierBlobstore might be a good option?

Some of the documentation is already in the javadoc and other parts are covered by amazon's
documentation. In any case I think this is a nice recap for someone who wants to find more
about this provider and its implementation. Back when I started with Glacier, something like
this for S3, Atmos or Azureblob would have been really helpful.

In any case, I think we should discuss this once you review the content. I'd like to know
your opinion.

---
Reply to this email directly or view it on GitHub:
https://github.com/jclouds/jclouds-labs-aws/pull/54#issuecomment-51036370
Mime
View raw message