clarify rebuild and add docstrings for partial rebuild
Merge pull request #289 from chhantyal/docs/clarify_method_rebuild

add docstrings for partial rebuild