documentation update for the new situation