(PE-3098) Added some documentation regarding the lifecycle changes