updating section I and II of the documentation