Additional clarifications about comments and documentation