updating comments and translating

commenting on the function arguments and translating function to english