[{"data":1,"prerenderedAt":664},["ShallowReactive",2],{"content-query-blLzBKmnnc":3},{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"date":10,"cover":11,"type":12,"state":13,"body":14,"_type":658,"_id":659,"_source":660,"_file":661,"_stem":662,"_extension":663},"/activities/zh/408","zh",false,"","春雷惊百虫，大家来找“茬”~","给我们的资料帖提意见和建议，API页面找错均可获得精美礼品！","2021-03-05","https://obs-mindspore-file.obs.cn-north-4.myhuaweicloud.com/file/2021/03/05/d5923c16e2f04800a9dcae5e6c21f50f.png","activities",1,{"type":15,"children":16,"toc":646},"root",[17,25,31,36,41,47,53,58,78,83,92,97,102,110,115,120,128,133,139,145,159,164,169,180,185,196,207,212,224,230,235,239,259,265,270,284,288,299,305,316,327,332,337,342,347,352,357,362,367,372,377,382,387,392,397,402,407,412,417,422,427,432,437,442,447,452,457,462,467,472,477,482,487,492,497,503,508,513,521,526,531,536,541,546,551,556,561,566,571,576,581,585,593,598,603,608,616,621,626,631,636,641],{"type":18,"tag":19,"props":20,"children":22},"element","h1",{"id":21},"春雷惊百虫大家来找茬",[23],{"type":24,"value":8},"text",{"type":18,"tag":26,"props":27,"children":28},"p",{},[29],{"type":24,"value":30},"一鼓轻雷惊蛰后，细筛微雨落梅天。",{"type":18,"tag":26,"props":32,"children":33},{},[34],{"type":24,"value":35},"今天是惊蛰哦，所谓春雷始鸣，万物萌生，又是新的一年啦，大家有没有设置新的目标啊？MindSpore希望陪伴着你们一起进步！",{"type":18,"tag":26,"props":37,"children":38},{},[39],{"type":24,"value":40},"九九已尽，春耕不停歇，我们的活动也是一波接着一波，希望大家持续关注！",{"type":18,"tag":19,"props":42,"children":44},{"id":43},"活动时间3月5日3月21日",[45],{"type":24,"value":46},"活动时间：3月5日——3月21日",{"type":18,"tag":19,"props":48,"children":50},{"id":49},"奖品说明",[51],{"type":24,"value":52},"奖品说明：",{"type":18,"tag":26,"props":54,"children":55},{},[56],{"type":24,"value":57},"活动一和活动二可同时参加！兼中兼得！",{"type":18,"tag":26,"props":59,"children":60},{},[61,63,69,71,76],{"type":24,"value":62},"活动一限额",{"type":18,"tag":64,"props":65,"children":66},"strong",{},[67],{"type":24,"value":68},"20",{"type":24,"value":70},"份（采纳视为通过）活动二",{"type":18,"tag":64,"props":72,"children":73},{},[74],{"type":24,"value":75},"不设上限",{"type":24,"value":77},"！",{"type":18,"tag":26,"props":79,"children":80},{},[81],{"type":24,"value":82},"活动一奖池：4选1",{"type":18,"tag":26,"props":84,"children":85},{},[86],{"type":18,"tag":87,"props":88,"children":91},"img",{"alt":89,"src":90},"1.png","https://bbs-img-cbc-cn.obs.cn-north-1.myhuaweicloud.com/data/forums/attachment/forum/202103/05/115752pcpvauvfrckidjip.png",[],{"type":18,"tag":26,"props":93,"children":94},{},[95],{"type":24,"value":96},"充电电池套装 手持吸尘器 跳绳 温度湿度计",{"type":18,"tag":26,"props":98,"children":99},{},[100],{"type":24,"value":101},"活动二奖池：4选1",{"type":18,"tag":26,"props":103,"children":104},{},[105],{"type":18,"tag":87,"props":106,"children":109},{"alt":107,"src":108},"2.png","https://bbs-img-cbc-cn.obs.cn-north-1.myhuaweicloud.com/data/forums/attachment/forum/202103/05/1158087gqiz0q62ala0i7e.png",[],{"type":18,"tag":26,"props":111,"children":112},{},[113],{"type":24,"value":114},"电饼铛 汤炖锅 香薰加湿器 养生壶",{"type":18,"tag":26,"props":116,"children":117},{},[118],{"type":24,"value":119},"活动二升级奖池：活动二奖池加入以下四件商品8选1",{"type":18,"tag":26,"props":121,"children":122},{},[123],{"type":18,"tag":87,"props":124,"children":127},{"alt":125,"src":126},"3.png","https://bbs-img-cbc-cn.obs.cn-north-1.myhuaweicloud.com/data/forums/attachment/forum/202103/05/115827sbhohk22uyaiuy6f.png",[],{"type":18,"tag":26,"props":129,"children":130},{},[131],{"type":24,"value":132},"电动牙刷 蓝牙耳机 篮球 工具套装",{"type":18,"tag":19,"props":134,"children":136},{"id":135},"活动内容",[137],{"type":24,"value":138},"活动内容：",{"type":18,"tag":140,"props":141,"children":143},"h2",{"id":142},"活动一",[144],{"type":24,"value":142},{"type":18,"tag":26,"props":146,"children":147},{},[148,150],{"type":24,"value":149},"MindSpore论坛推出了资料整理帖：",{"type":18,"tag":151,"props":152,"children":156},"a",{"href":153,"rel":154},"https://bbs.huaweicloud.com/forum/thread-106722-1-1.html",[155],"nofollow",[157],{"type":24,"value":158},"一站式学习MindSpore|看你想看",{"type":18,"tag":26,"props":160,"children":161},{},[162],{"type":24,"value":163},"由浅入深总结了目前公开的各平台上的资料，欢迎大家去阅读使用，同时也希望大家根据实际使用体验，对资料帖的分类，内容，结构等提出意见或者建议。",{"type":18,"tag":26,"props":165,"children":166},{},[167],{"type":24,"value":168},"外部平台主要有：",{"type":18,"tag":26,"props":170,"children":171},{},[172,174],{"type":24,"value":173},"官网资讯：",{"type":18,"tag":151,"props":175,"children":178},{"href":176,"rel":177},"https://www.mindspore.cn/news",[155],[179],{"type":24,"value":176},{"type":18,"tag":26,"props":181,"children":182},{},[183],{"type":24,"value":184},"公众号：微信搜索“mindspore”",{"type":18,"tag":26,"props":186,"children":187},{},[188,190],{"type":24,"value":189},"哔哩哔哩：",{"type":18,"tag":151,"props":191,"children":194},{"href":192,"rel":193},"https://space.bilibili.com/526894060?from=search&seid=3675452334887615774",[155],[195],{"type":24,"value":192},{"type":18,"tag":26,"props":197,"children":198},{},[199,201],{"type":24,"value":200},"MindSpore论坛：",{"type":18,"tag":151,"props":202,"children":205},{"href":203,"rel":204},"https://bbs.huaweicloud.com/forum/forum-1076-1.html",[155],[206],{"type":24,"value":203},{"type":18,"tag":26,"props":208,"children":209},{},[210],{"type":24,"value":211},"参与方式",{"type":18,"tag":26,"props":213,"children":214},{},[215,217,222],{"type":24,"value":216},"将资料帖的意见建议提交至MindSpore论坛的“活动体验”分类，",{"type":18,"tag":64,"props":218,"children":219},{},[220],{"type":24,"value":221},"附上自己的邮箱",{"type":24,"value":223},"，标题注明：资料帖意见建议",{"type":18,"tag":140,"props":225,"children":227},{"id":226},"活动二",[228],{"type":24,"value":229},"活动二：",{"type":18,"tag":26,"props":231,"children":232},{},[233],{"type":24,"value":234},"检查出MindSpore官网Python API页面的错误。",{"type":18,"tag":26,"props":236,"children":237},{},[238],{"type":24,"value":211},{"type":18,"tag":26,"props":240,"children":241},{},[242,244,251,253,257],{"type":24,"value":243},"找出API页面的错误（",{"type":18,"tag":151,"props":245,"children":248},{"href":246,"rel":247},"https://www.mindspore.cn/doc/api_python/zh-CN/r1.1/index.html",[155],[249],{"type":24,"value":250},"Python API页面",{"type":24,"value":252},"），提交至MindSpore论坛的“活动体验”分类，",{"type":18,"tag":64,"props":254,"children":255},{},[256],{"type":24,"value":221},{"type":24,"value":258},"，标题注明：API存在的问题。",{"type":18,"tag":140,"props":260,"children":262},{"id":261},"活动二进阶",[263],{"type":24,"value":264},"活动二进阶：",{"type":18,"tag":26,"props":266,"children":267},{},[268],{"type":24,"value":269},"找出API页面的错误并在gitee上提交PR修改，合入后可获得升级奖励！",{"type":18,"tag":26,"props":271,"children":272},{},[273,275,282],{"type":24,"value":274},"提交PR的流程和注意事项可以参考：***",{"type":18,"tag":151,"props":276,"children":279},{"href":277,"rel":278},"https://bbs.huaweicloud.com/forum/thread-111208-1-1.html",[155],[280],{"type":24,"value":281},"gitee上提交PR注意事项",{"type":24,"value":283},"***",{"type":18,"tag":26,"props":285,"children":286},{},[287],{"type":24,"value":211},{"type":18,"tag":26,"props":289,"children":290},{},[291,293,297],{"type":24,"value":292},"找出API页面的错误并提交PR修改，将API问题和PR链接提交至MindSpore论坛的“活动体验”分类，",{"type":18,"tag":64,"props":294,"children":295},{},[296],{"type":24,"value":221},{"type":24,"value":298},"，标题注明：API存在的问题和修改。",{"type":18,"tag":140,"props":300,"children":302},{"id":301},"为方便各位查找我们给出检查要点提供给各位参考具体如下",[303],{"type":24,"value":304},"为方便各位查找，我们给出检查要点提供给各位参考，具体如下：",{"type":18,"tag":26,"props":306,"children":307},{},[308,310],{"type":24,"value":309},"1. 打开API参考页面：",{"type":18,"tag":151,"props":311,"children":314},{"href":312,"rel":313},"https://www.mindspore.cn/docs/zh-CN/r1.8/index.html",[155],[315],{"type":24,"value":312},{"type":18,"tag":26,"props":317,"children":318},{},[319,321],{"type":24,"value":320},"2. 查看gitee仓库：",{"type":18,"tag":151,"props":322,"children":325},{"href":323,"rel":324},"https://gitee.com/mindspore/mindspore/tree/master/mindspore",[155],[326],{"type":24,"value":323},{"type":18,"tag":26,"props":328,"children":329},{},[330],{"type":24,"value":331},"检查要点",{"type":18,"tag":26,"props":333,"children":334},{},[335],{"type":24,"value":336},"1. 整体检查该API功能描述是否完整，该API是做什么、计算过程是什么。",{"type":18,"tag":26,"props":338,"children":339},{},[340],{"type":24,"value":341},"对于功能复杂API，需要结合示例说明API的功能和约束。",{"type":18,"tag":26,"props":343,"children":344},{},[345],{"type":24,"value":346},"该API页面的显示是否正常：超链接、表格、公式、列表、样例代码等。",{"type":18,"tag":26,"props":348,"children":349},{},[350],{"type":24,"value":351},"2. 特殊说明使用Note进行说明。",{"type":18,"tag":26,"props":353,"children":354},{},[355],{"type":24,"value":356},"3. 针对mindspore.nn和mindspore.ops模块里的算子的API，需要给出算子对应的公式，注意公式引用是否合理，显示是否正确。",{"type":18,"tag":26,"props":358,"children":359},{},[360],{"type":24,"value":361},"需要有Inputs描述算子的输入类型和shape。注意输入类型是否正确。",{"type":18,"tag":26,"props":363,"children":364},{},[365],{"type":24,"value":366},"需要有Outputs描述算子的输出类型和shape。注意输出类型是否正确。",{"type":18,"tag":26,"props":368,"children":369},{},[370],{"type":24,"value":371},"4. Parameters中参数",{"type":18,"tag":26,"props":373,"children":374},{},[375],{"type":24,"value":376},"1. 需要和源代码中的传入参数一致。",{"type":18,"tag":26,"props":378,"children":379},{},[380],{"type":24,"value":381},"2. 参数若存在默认值需要给出，和源代码中一致。",{"type":18,"tag":26,"props":383,"children":384},{},[385],{"type":24,"value":386},"3. 参数值是否有取值范围限制（与源码中的对应）。",{"type":18,"tag":26,"props":388,"children":389},{},[390],{"type":24,"value":391},"4. 数据类型要准确:",{"type":18,"tag":26,"props":393,"children":394},{},[395],{"type":24,"value":396},"- 基本数据类型：int，float，bool，str，list，dict，set，tuple。",{"type":18,"tag":26,"props":398,"children":399},{},[400],{"type":24,"value":401},"- 其他数据类型：包括mindspore.dtype、numpy.dtype，其他的则使用其对应的类型名称。",{"type":18,"tag":26,"props":403,"children":404},{},[405],{"type":24,"value":406},"5. Raise触发到的异常描述是否和Raises中描述的一致。",{"type":18,"tag":26,"props":408,"children":409},{},[410],{"type":24,"value":411},"是否触发到未给出的异常。",{"type":18,"tag":26,"props":413,"children":414},{},[415],{"type":24,"value":416},"6. Examples中：",{"type":18,"tag":26,"props":418,"children":419},{},[420],{"type":24,"value":421},"- 示例代码需要完整而且正确运行，要展示输出结果或维度等信息。",{"type":18,"tag":26,"props":423,"children":424},{},[425],{"type":24,"value":426},"- 关键词要和代码要求里保持一致。",{"type":18,"tag":26,"props":428,"children":429},{},[430],{"type":24,"value":431},"- 复杂的调用需要添加注释进行说明。",{"type":18,"tag":26,"props":433,"children":434},{},[435],{"type":24,"value":436},"- 传入的参数是否和Parameters中描述的一致，有无Parameters中没有的。",{"type":18,"tag":26,"props":438,"children":439},{},[440],{"type":24,"value":441},"- 输出结果和Outputs中是否一致，是否正确。",{"type":18,"tag":26,"props":443,"children":444},{},[445],{"type":24,"value":446},"- 是否对运行环境有特殊要求，是否支持所有环境（GPU,CPU Ascend），若不是则注释给出要求说明；",{"type":18,"tag":26,"props":448,"children":449},{},[450],{"type":24,"value":451},"- 同一个变量的书写前后是否一致",{"type":18,"tag":26,"props":453,"children":454},{},[455],{"type":24,"value":456},"- 参考其他的Examples，需要在Note中指出。",{"type":18,"tag":26,"props":458,"children":459},{},[460],{"type":24,"value":461},"- 业界共识的情况可省略相关导入（import），如np、nn等。否则不能省略。",{"type":18,"tag":26,"props":463,"children":464},{},[465],{"type":24,"value":466},"- 采用PyNative模式，可运行的需给出运行结果。",{"type":18,"tag":26,"props":468,"children":469},{},[470],{"type":24,"value":471},"- 引用的接口新发布版本中是否已更新。",{"type":18,"tag":26,"props":473,"children":474},{},[475],{"type":24,"value":476},"7. 引用的链接是否正常或失效。",{"type":18,"tag":26,"props":478,"children":479},{},[480],{"type":24,"value":481},"8. 相关命名是否按照术语表书写。如：LeNet、Ascend、LSTM等。",{"type":18,"tag":26,"props":483,"children":484},{},[485],{"type":24,"value":486},"9. 该API是否具有运行平台支持要求，在`Supported Platforms`中的要求需要正确。",{"type":18,"tag":26,"props":488,"children":489},{},[490],{"type":24,"value":491},"10. 不能出现中文的“说明”字样。",{"type":18,"tag":19,"props":493,"children":495},{"id":494},"案例",[496],{"type":24,"value":494},{"type":18,"tag":498,"props":499,"children":501},"h3",{"id":500},"正确案例",[502],{"type":24,"value":500},{"type":18,"tag":26,"props":504,"children":505},{},[506],{"type":24,"value":507},"mindspore.nn.BatchNorm2d",{"type":18,"tag":26,"props":509,"children":510},{},[511],{"type":24,"value":512},"该算子API的显示效果如下图所示：",{"type":18,"tag":26,"props":514,"children":515},{},[516],{"type":18,"tag":87,"props":517,"children":520},{"alt":518,"src":519},"BatchNorm2d.png","https://bbs-img-cbc-cn.obs.cn-north-1.myhuaweicloud.com/data/forums/attachment/forum/202103/05/111810cljtv2bz3bz9yvhz.png",[],{"type":18,"tag":26,"props":522,"children":523},{},[524],{"type":24,"value":525},"经过以上检查要点的检查之后可知该API的描述是完整的，具体包括以下内容：",{"type":18,"tag":26,"props":527,"children":528},{},[529],{"type":24,"value":530},"1. 整体检查可知显示正常，无格式错误。",{"type":18,"tag":26,"props":532,"children":533},{},[534],{"type":24,"value":535},"2. 最开始的一句话功能描述。",{"type":18,"tag":26,"props":537,"children":538},{},[539],{"type":24,"value":540},"3. 后续的详细功能描述，其中给出了该算子的公式，且公式正确。。",{"type":18,"tag":26,"props":542,"children":543},{},[544],{"type":24,"value":545},"4. 给出了特殊说明Note。",{"type":18,"tag":26,"props":547,"children":548},{},[549],{"type":24,"value":550},"5. Parameters中的参数和该算子的定义中一致，有参数类型，且传入参数描述准确。",{"type":18,"tag":26,"props":552,"children":553},{},[554],{"type":24,"value":555},"6. 具有Inputs描述了算子的输入，Outputs描述了算子的输出，且输入、输出类型正确，描述准确。",{"type":18,"tag":26,"props":557,"children":558},{},[559],{"type":24,"value":560},"7. Raises给出了异常描述。",{"type":18,"tag":26,"props":562,"children":563},{},[564],{"type":24,"value":565},"8. Supported Platforms给出了平台支持情况。",{"type":18,"tag":26,"props":567,"children":568},{},[569],{"type":24,"value":570},"9. Examples给出了使用示例，且运行正确。",{"type":18,"tag":498,"props":572,"children":574},{"id":573},"案例2",[575],{"type":24,"value":573},{"type":18,"tag":26,"props":577,"children":578},{},[579],{"type":24,"value":580},"1. mindspore.nn.Momentum",{"type":18,"tag":26,"props":582,"children":583},{},[584],{"type":24,"value":512},{"type":18,"tag":26,"props":586,"children":587},{},[588],{"type":18,"tag":87,"props":589,"children":592},{"alt":590,"src":591},"Momentum.png","https://bbs-img-cbc-cn.obs.cn-north-1.myhuaweicloud.com/data/forums/attachment/forum/202103/05/111726r20l3ci2ve7aiwyz.png",[],{"type":18,"tag":26,"props":594,"children":595},{},[596],{"type":24,"value":597},"经过以上检查要点的检查之后可知该API中具有中文的“说明”样式，是属于错误格式，需要修正。其他的描述是完整和正确的。",{"type":18,"tag":26,"props":599,"children":600},{},[601],{"type":24,"value":602},"2. mindspore_serving.worker.register.call_preprocess_pipeline",{"type":18,"tag":26,"props":604,"children":605},{},[606],{"type":24,"value":607},"该API的显示效果如下图所示：",{"type":18,"tag":26,"props":609,"children":610},{},[611],{"type":18,"tag":87,"props":612,"children":615},{"alt":613,"src":614},"call_preprocess_pipeline.png","https://bbs-img-cbc-cn.obs.cn-north-1.myhuaweicloud.com/data/forums/attachment/forum/202103/05/111851kdsdml5n4hhipoti.png",[],{"type":18,"tag":26,"props":617,"children":618},{},[619],{"type":24,"value":620},"经过以上检查要点的检查之后可知该API中超链接显示不正确，是属于错误格式，需要修正。其他的描述是完整和正确的。",{"type":18,"tag":19,"props":622,"children":624},{"id":623},"注意事项",[625],{"type":24,"value":623},{"type":18,"tag":26,"props":627,"children":628},{},[629],{"type":24,"value":630},"1. 提交PR到gitee指定位置。",{"type":18,"tag":26,"props":632,"children":633},{},[634],{"type":24,"value":635},"2. 所有活动中提交内容若相同或相似，后提交者视作无效参与。",{"type":18,"tag":26,"props":637,"children":638},{},[639],{"type":24,"value":640},"3. 最终解释权归MindSpore团队所有。",{"type":18,"tag":26,"props":642,"children":643},{},[644],{"type":24,"value":645},"4. 如遇奖品缺货或者地区限制，将自动更换为同等价值类似商品。",{"title":7,"searchDepth":647,"depth":647,"links":648},4,[649,651,652,653],{"id":142,"depth":650,"text":142},2,{"id":226,"depth":650,"text":229},{"id":261,"depth":650,"text":264},{"id":301,"depth":650,"text":304,"children":654},[655,657],{"id":500,"depth":656,"text":500},3,{"id":573,"depth":656,"text":573},"markdown","content:activities:zh:408.md","content","activities/zh/408.md","activities/zh/408","md",1776506035662]