update, descriptions and comments