updated documentation of the important files