UG: Enhance suite init file docs.

Includes better explanation how to share kws/vars using resources files. Fixes #1851.