Revise repository tool README and fix assertTrue() issues in test_updater.py

The repository tool document was revised to include high-level text and address organizational issues.
`test_updater.py` was updated to convert any remaining assertTrue() calls to assertEqual(), when required.