add missing comments for spec document