Address editor comments for Lay of the Land

* format note as warning
* increase explanation of OS_CACHE tip

Change-Id: I22e3c7af87ddd27625d11f66570f7c1c5306bb7c
Merge "Address editor comments for Lay of the Land"