春雷惊百虫，大家来找“茬”~
春雷惊百虫，大家来找“茬”~
一鼓轻雷惊蛰后，细筛微雨落梅天。
今天是惊蛰哦，所谓春雷始鸣，万物萌生，又是新的一年啦，大家有没有设置新的目标啊？MindSpore希望陪伴着你们一起进步！
九九已尽，春耕不停歇，我们的活动也是一波接着一波，希望大家持续关注！
活动时间：3月5日——3月21日
奖品说明：
活动一和活动二可同时参加！兼中兼得！
活动一限额20份（采纳视为通过）活动二不设上限！
活动一奖池：4选1
充电电池套装 手持吸尘器 跳绳 温度湿度计
活动二奖池：4选1
电饼铛 汤炖锅 香薰加湿器 养生壶
活动二升级奖池：活动二奖池加入以下四件商品8选1
电动牙刷 蓝牙耳机 篮球 工具套装
活动内容：
活动一
MindSpore论坛推出了资料整理帖：一站式学习MindSpore|看你想看
由浅入深总结了目前公开的各平台上的资料，欢迎大家去阅读使用，同时也希望大家根据实际使用体验，对资料帖的分类，内容，结构等提出意见或者建议。
外部平台主要有：
官网资讯：https://www.mindspore.cn/news
公众号：微信搜索“mindspore”
哔哩哔哩：https://space.bilibili.com/526894060?from=search&seid=3675452334887615774
MindSpore论坛：https://bbs.huaweicloud.com/forum/forum-1076-1.html
参与方式
将资料帖的意见建议提交至MindSpore论坛的“活动体验”分类，附上自己的邮箱，标题注明：资料帖意见建议
活动二：
检查出MindSpore官网Python API页面的错误。
参与方式
找出API页面的错误（Python API页面），提交至MindSpore论坛的“活动体验”分类，附上自己的邮箱，标题注明：API存在的问题。
活动二进阶：
找出API页面的错误并在gitee上提交PR修改，合入后可获得升级奖励！
提交PR的流程和注意事项可以参考：***gitee上提交PR注意事项***
参与方式
找出API页面的错误并提交PR修改，将API问题和PR链接提交至MindSpore论坛的“活动体验”分类，附上自己的邮箱，标题注明：API存在的问题和修改。
为方便各位查找，我们给出检查要点提供给各位参考，具体如下：
1. 打开API参考页面：https://www.mindspore.cn/docs/zh-CN/r1.8/index.html
2. 查看gitee仓库：https://gitee.com/mindspore/mindspore/tree/master/mindspore
检查要点
1. 整体检查该API功能描述是否完整，该API是做什么、计算过程是什么。
对于功能复杂API，需要结合示例说明API的功能和约束。
该API页面的显示是否正常：超链接、表格、公式、列表、样例代码等。
2. 特殊说明使用Note进行说明。
3. 针对mindspore.nn和mindspore.ops模块里的算子的API，需要给出算子对应的公式，注意公式引用是否合理，显示是否正确。
需要有Inputs描述算子的输入类型和shape。注意输入类型是否正确。
需要有Outputs描述算子的输出类型和shape。注意输出类型是否正确。
4. Parameters中参数
1. 需要和源代码中的传入参数一致。
2. 参数若存在默认值需要给出，和源代码中一致。
3. 参数值是否有取值范围限制（与源码中的对应）。
4. 数据类型要准确:
- 基本数据类型：int，float，bool，str，list，dict，set，tuple。
- 其他数据类型：包括mindspore.dtype、numpy.dtype，其他的则使用其对应的类型名称。
5. Raise触发到的异常描述是否和Raises中描述的一致。
是否触发到未给出的异常。
6. Examples中：
- 示例代码需要完整而且正确运行，要展示输出结果或维度等信息。
- 关键词要和代码要求里保持一致。
- 复杂的调用需要添加注释进行说明。
- 传入的参数是否和Parameters中描述的一致，有无Parameters中没有的。
- 输出结果和Outputs中是否一致，是否正确。
- 是否对运行环境有特殊要求，是否支持所有环境（GPU,CPU Ascend），若不是则注释给出要求说明；
- 同一个变量的书写前后是否一致
- 参考其他的Examples，需要在Note中指出。
- 业界共识的情况可省略相关导入（import），如np、nn等。否则不能省略。
- 采用PyNative模式，可运行的需给出运行结果。
- 引用的接口新发布版本中是否已更新。
7. 引用的链接是否正常或失效。
8. 相关命名是否按照术语表书写。如：LeNet、Ascend、LSTM等。
9. 该API是否具有运行平台支持要求，在`Supported Platforms`中的要求需要正确。
10. 不能出现中文的“说明”字样。
案例
正确案例
mindspore.nn.BatchNorm2d
该算子API的显示效果如下图所示：
经过以上检查要点的检查之后可知该API的描述是完整的，具体包括以下内容：
1. 整体检查可知显示正常，无格式错误。
2. 最开始的一句话功能描述。
3. 后续的详细功能描述，其中给出了该算子的公式，且公式正确。。
4. 给出了特殊说明Note。
5. Parameters中的参数和该算子的定义中一致，有参数类型，且传入参数描述准确。
6. 具有Inputs描述了算子的输入，Outputs描述了算子的输出，且输入、输出类型正确，描述准确。
7. Raises给出了异常描述。
8. Supported Platforms给出了平台支持情况。
9. Examples给出了使用示例，且运行正确。
案例2
1. mindspore.nn.Momentum
该算子API的显示效果如下图所示：
经过以上检查要点的检查之后可知该API中具有中文的“说明”样式，是属于错误格式，需要修正。其他的描述是完整和正确的。
2. mindspore_serving.worker.register.call_preprocess_pipeline
该API的显示效果如下图所示：
经过以上检查要点的检查之后可知该API中超链接显示不正确，是属于错误格式，需要修正。其他的描述是完整和正确的。
注意事项
1. 提交PR到gitee指定位置。
2. 所有活动中提交内容若相同或相似，后提交者视作无效参与。
3. 最终解释权归MindSpore团队所有。
4. 如遇奖品缺货或者地区限制，将自动更换为同等价值类似商品。