public from private: add code comments