added a few notes based on review of commit logs