better comments on go implementation