spec out deletion from bucket-typed buckets
document and safeguard methods on bucket-typed buckets
documentation comments