fixed object pool to not ever get stuck on usage pattern changes
- added a tiny docs modification for the previous commit