add spec for bucket typed buckets used with key filters
document more bucket type api bits
More bucket type education in the realm.