Feedback from review

Author: nhorton

doc/policy_syntax.md

@@ -36,7 +36,7 @@ class AuthService:
 trigger: src/**/*
 safety: README.md
 ---
-Source code changed. Please verify README.md is accurate.
+Source code changed. Please verify README.md is accurate. Note that this is called only once even if there are many changes, so verify all changes.
 
 Check that:
 - All public APIs are documented

doc/policy_system_design.md

@@ -306,6 +306,14 @@ The following policies require attention:
 1. **Source/Test Pairing**: src/auth/login.py changed without tests/auth/login_test.py
 2. **Source/Test Pairing**: src/api/users.py changed without tests/api/users_test.py
 3. **API Documentation**: api/users.py changed without docs/api/users.md
+ 
+[FEEDBACK] - these sections should all be shorter. Ex:
+## Source/Test Pairings
+src/auth/login.py changed without tests/auth/login_test.py
+src/api/users.py changed without tests/api/users_test.py
+
+## API Documentation
+api/users.py changed without docs/api/users.md
 
 ## Code Quality (1)