Storage "Interface Driven Design" Document

[dhermes]

Still in flux (as of filing).

Follow along changes in:
www.googledrive.com/host/0B8el7dRo8mVOMk1HbFk4TVhDaEE

/cc @jgeewax @tseaver I'll ping Travis when it is complete.

UPDATE (March 30): @thobrla PTAL. @jgeewax asked me to design the final state of the desired surface area (all inspired by your bug #545). Our current code uses projection=noAcl to avoid loading ACL info with other metadata, while this hypothetical design ditches that concept.

[coveralls]

Coverage remained the same at 100.0% when pulling b725d9f on dhermes:storage-surface-doc into d34a15e on GoogleCloudPlatform:master.

[coveralls]

Coverage remained the same at 100.0% when pulling 73d60b7 on dhermes:storage-surface-doc into d34a15e on GoogleCloudPlatform:master.

[dhermes]

UPDATE: I have added everything except ACL sections. What a doozy! Please start reviewing. (I'm going to hold off on cc'ing Travis until I finish the ACL part.)

It's encouraged me to just throw away a few methods (e.g. Blob.rename()) and to make some protected to avoid distracting users.

[dhermes]

@tseaver All the comments without response I plan on addressing. I am away from keyboard today and will get to them tomorrow (March 28, 2015).

[coveralls]

Coverage remained the same at 100.0% when pulling 2a1eab6 on dhermes:storage-surface-doc into 4785201 on GoogleCloudPlatform:master.

[coveralls]

Coverage remained the same at 100.0% when pulling d84dc38 on dhermes:storage-surface-doc into 4785201 on GoogleCloudPlatform:master.

[dhermes]

@tseaver I have added ACL stuff and changed around a few of the things you already reviewed.