add comments about param shape