adding guidance  (ref: #585)