add explanation of how bucket types are assigned
progress on all fronts