Update Herald documentation for modern policies and beahvior
Update Herald documentation for modern policies and beahvior

Summary: Ref T11428. This documentation was a bit misleading and out of date. Update it to reflect modern reality.

Test Plan: Read documentation.

Reviewers: chad

Reviewed By: chad

Maniphest Tasks: T11428

Differential Revision: https://secure.phabricator.com/D16384

devurandom/phabricator,wikimedia/phabricator,phacility/phabricator,benchling/phabricator,wikimedia/phabricator,dannysu/phabricator,freebsd/phabricator,phacility/phabricator,Khan/phabricator,uhd-urz/phabricator,benchling/phabricator,kanarip/phabricator,Automatic/phabricator,hach-que/phabricator,vinzent/phabricator,benchling/phabricator,gsinkovskiy/phabricator,devurandom/phabricator,dannysu/phabricator,r4nt/phabricator,kanarip/phabricator,uhd-urz/phabricator,Automatic/phabricator,wikimedia/phabricator-phabricator,freebsd/phabricator,dannysu/phabricator,folsom-labs/phabricator,wikimedia/phabricator,uhd-urz/phabricator,vinzent/phabricator,vinzent/phabricator,kanarip/phabricator,r4nt/phabricator,hach-que/phabricator,MicroWorldwide/phabricator,folsom-labs/phabricator,dannysu/phabricator,devurandom/phabricator,uhd-urz/phabricator,wikimedia/phabricator-phabricator,MicroWorldwide/phabricator,wikimedia/phabricator-phabricator,Khan/phabricator,folsom-labs/phabricator,freebsd/phabricator,vinzent/phabricator,uhd-urz/phabricator,devurandom/phabricator,huangjimmy/phabricator-1,gsinkovskiy/phabricator,Khan/phabricator,aik099/phabricator,gsinkovskiy/phabricator,benchling/phabricator,wikimedia/phabricator-phabricator,huangjimmy/phabricator-1,hach-que/phabricator,r4nt/phabricator,gsinkovskiy/phabricator,kanarip/phabricator,wikimedia/phabricator,Khan/phabricator,Automatic/phabricator,gsinkovskiy/phabricator,hach-que/phabricator,devurandom/phabricator,dannysu/phabricator,MicroWorldwide/phabricator,wikimedia/phabricator-phabricator,huangjimmy/phabricator-1,MicroWorldwide/phabricator,phacility/phabricator,phacility/phabricator,Automatic/phabricator,folsom-labs/phabricator,aik099/phabricator,vinzent/phabricator,freebsd/phabricator,r4nt/phabricator,aik099/phabricator,aik099/phabricator,huangjimmy/phabricator-1,folsom-labs/phabricator,devurandom/phabricator,kanarip/phabricator,huangjimmy/phabricator-1,hach-que/phabricator,r4nt/phabricator