small improvements and comments translated to english