style nit: please annotate all public methods