代码拉取完成，页面将自动刷新
同步操作将从 MindSpore/docs 强制同步，此操作会覆盖自 Fork 仓库以来所做的任何修改，且无法恢复！！！
确定后同步将在后台操作，完成时将刷新页面，请耐心等待。
You are welcome to contribute MindSpore documents. Documents that meet requirements will be displayed on the MindSpore website.
This project supports contribution documents in markdown and reStructuredText formats. You can create .md or .rst files or modify existing files.
MindSpore docs repository provides Document Writing Specifications for your reference.
If you want to update an existing document, click View source on Gitee (as shown in the following figure) on the top of the page to go to the source file. Modify the document and commit changes to a PR to make the contribution.
If you need to add a document, create a markdown or reStructuredText file in a proper directory. For details about the directory structure of the MindSpore docs repository, see README.
Create a document.
Requirements for a new document are as follows:
source_en.Add the new document to the web page.
After the writing is complete, add the new document to the web page directory.
Take a training tutorial as an example. Find the index.rst file in the source_en directory. This file corresponds to the organization structure of the training tutorial web page.
Add the new document to the corresponding category. You can also create a category before adding the document. Take Implementing an Image Classification Application as an example. Save the document in the quick_start directory and name it as quick_start.md. Add quick_start/quick_start to the Quick Start category, as shown below.
.. toctree::
:glob:
:maxdepth: 1
:caption: Quick Start
:hidden:
quick_start/quick_start
quick_start/linear_regression
quick_start/quick_video
After completing the preceding operations, commit to a PR to make contribution.
After committing to a PR, ensure that the mindspore-cla/yes and ci-pipeline-passed labels exist and the stat/need-squash label does not exist. The PR can be merged only after being approved by the committer.
mindspore-cla/yes: indicates that the CLA has been properly signed. If the CLA is not signed, the system automatically adds the mindspore-cla/no label. After the CLA is signed, add the comment /check-cla under the PR. Then the mindspore-cla/yes label is automatically added.ci-pipeline-passed: indicates that the MindSpore CI check is passed. When a PR is created, MindSpore CI automatically starts the check. If the check is passed, the system automatically adds the label. If the check fails, the system automatically adds the ci-pipeline-failed label. After problems are resolved, add the comment /retest under the PR. If the check is successful, the ci-pipeline-passed label is automatically added.stat/need-squash: indicates that the PR has multiple commits. The label is automatically deleted only after the commits are merged into one commit through the git rebase operation.MindSpore CI uses check tools such as Markdownlint, Pylint, Shellcheck, Cppcheck, Cpplint, and Tab.
Markdownlint is a tool for checking the markdown file format. You can use the tool to check the format based on the configured rules and new rules. MindSpore CI modifies the following rules based on the default configuration:
For details, see RULES.
On the next day after the PR is merged, you can view the new content on the MindSpore website. A new link will be created for the new document.
By default, tutorials and documents of the latest version are displayed on the official website. To view the newly merged content, switch to master from the drop-down list.
Take Quick Start for Beginners as an example. The document link is https://www.mindspore.cn/tutorials/en/master/beginner/quick_start.html.
MindSpore docs repository provides API Comment Specifications for your reference.
If you want to update an existing API, find the source file of the API in the MindSpore code.
If you do not know the file link, click source and find the file link by referring to the content following _modules in the link.
Take Tensor as an example. After clicking source, you can obtain the link https://www.mindspore.cn/docs/en/master/_modules/mindspore/common/tensor.html#Tensor. Then, the source file link is https://gitee.com/mindspore/mindspore/blob/master/mindspore/python/mindspore/common/tensor.py.
Modify the comments in the source file and commit changes to a PR to make the contribution.
If you want to add an API, check whether the API has been added to an existing module. For details about the existing modules, see https://www.mindspore.cn/docs/en/master/index.html.
If the API belongs to an existing module, comment out the API in the MindSpore code repository based on the requirements and add the API to __all__ of the corresponding module. Ensure that the API can be used in importing mindspore.Module name.API name format.
If the API belongs to the following modules, the API list of the MindSpore docs repository needs to be updated. Please add APIs in alphabetical order.
If the API does not belong to the existing module, add an API project file of the MindSpore docs repository. Please add modules to the directory structure in alphabetical order. To add the API of the mindspore.mindrecord module, you need to create the mindspore.mindrecord.rst file in the docs/docs/api_python/source_en/mindspore directory and add the file to the directory structure.
.. toctree::
:maxdepth: 1
:caption: MindSpore Python API
...
mindspore/mindspore.mindrecord
...
After completing the preceding modification, commit to a PR to make contribution.
After committing to a PR, ensure that the mindspore-cla/yes and ci-pipeline-passed labels exist and the stat/need-squash label does not exist. The PR can be merged only after being approved by the committer.
For details about each label, see Checking a Document.
MindSpore CI uses the Pylint check tool.
On the next day after the PR is merged, you can view the new content on the MindSpore Python API page.
By default, APIs of the latest version are displayed. To view the newly merged content, switch to the master version.
The images in the document are mainly divided into program flowcharts, configuration flowcharts, functional structure diagrams and so on.
For specific image requirements and specifications, please refer to Image Specifications provided by MindSpore docs.
If you want to update an existing image or adding a new image, click on the top of the page to go to the source file. Usually the images will be stored in the directory ./images. You only need to put the new images into this directory, or replace the modified images with the original ones, and commit changes to a PR to make the contribution.
Please submit the original image to Gitee at the same time, and put it in the same path as the image for subsequent modification.
The format of the image citation is: ![image name] (the path where the image is located). For details, please refer to Markdown Image Citation Requirements and Notebook Image Citation Requirements.
On the next day after the PR is merged, you can view the new content on the MindSpore website. The new image will be shown in the document.
By default, tutorials and documents of the latest version are displayed on the official website. To view the newly merged content, switch to master from the drop-down list.
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。