Add comments encouraging use of toggle_in_navigation() method and smarted cache invalidation on its use.

Signed-off-by: Martin Koistinen <mkoistinen@gmail.com>
Merge pull request #2741 from mkoistinen/toggle_in_navigation

Smarter cache invalidation on use of toggle_in_navigation()