[MNG-5076] improved documentation of lifecycle.xml Submitted by: Benson Margulies applied with modifications merged from 2.2 branch r1096335