Added additional clarifications and comments on @endpoint