[minor] Added a points() api
[doc] Added more comments