add docstrings for partial rebuild

While this is minor change, I found myself scrolling through docs looking for more about partial_rebuild which was added in 0.6.0.

Reading source code is always an option, but I think there are many people who find reading docs a better option. I hope this change adds a clarity :)