diff --git a/.gitignore b/.gitignore index eb9945b84cde66156884911642cfbb850b2d5e67..8783101f09c1492fa57bc7373459e850cac06121 100644 --- a/.gitignore +++ b/.gitignore @@ -13,6 +13,9 @@ /test/ut/retiarii/_debug_graph_data.json /test/ut/retiarii/out.tmp +# example generated files +/nni_assets/**/data/ + # Logs logs *.log diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md deleted file mode 100644 index 6ce61868689091e8231f0c697bd1fa4a1ab12ee7..0000000000000000000000000000000000000000 --- a/CONTRIBUTING.md +++ /dev/null @@ -1,68 +0,0 @@ -# Contributing to NNI - -Welcome, and thank you for your interest in contributing to NNI! - -There are many ways in which you can contribute, beyond writing code. The goal of this document is to provide a high-level overview of how you can get involved. - -# Provide feedback or ask a question - -* [File an issue](https://github.com/microsoft/nni/issues/new/choose) on GitHub. -* Ask a question with NNI tags on [Stack Overflow](https://stackoverflow.com/questions/tagged/nni?sort=Newest&edited=true). -* Discuss on the NNI [Gitter](https://gitter.im/Microsoft/nni?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) in NNI. - -Join IM discussion groups: -|Gitter||WeChat| -|----|----|----| -|| OR || - - -# Look for an existing issue -Before you create a new issue, please do a search in [open issues](https://github.com/microsoft/nni/issues) to see if the issue or feature request has already been filed. - -Be sure to scan through the [most popular](https://github.com/microsoft/nni/issues?q=is%3Aopen+is%3Aissue+label%3AFAQ+sort%3Areactions-%2B1-desc) feature requests. - -If you find your issue already exists, make relevant comments and add your [reaction](https://github.com/blog/2119-add-reactions-to-pull-requests-issues-and-comments). Use a reaction in place of a "+1" comment: - -* 👍 - upvote -* 👎 - downvote - -If you cannot find an existing issue that describes your bug or feature, create a new issue using the guidelines below. - -# Writing good bug reports or feature requests -File a single issue per problem and feature request. Do not enumerate multiple bugs or feature requests in the same issue. - -Provide as much information as you think might relevant to the context (thinking the issue is assigning to you, what kinds of info you will need to debug it!!!). To give you a general idea about what kinds of info are useful for developers to dig out the issue, we had provided issue template for you. - -Once you had submitted an issue, be sure to follow it for questions and discussions. - -Once the bug is fixed or feature is addressed, be sure to close the issue. - -# Contributing fixes or examples - -This project welcomes contributions and suggestions. Most contributions require you to agree to a -Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us -the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com. - -When you submit a pull request, a CLA bot will automatically determine whether you need to provide -a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions -provided by the bot. You will only need to do this once across all repos using our CLA. - -# Code of Conduct - -This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). -For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or -contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments. - -# How to Contribute - -After getting familiar with contribution agreements, you are ready to create your first PR =), follow the NNI developer tutorials to get start: - -* We recommend new contributors to start with simple issues: ['good first issue'](https://github.com/Microsoft/nni/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) or ['help-wanted'](https://github.com/microsoft/nni/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22). -* [NNI developer environment installation tutorial](docs/en_US/Tutorial/SetupNniDeveloperEnvironment.rst) -* [How to debug](docs/en_US/Tutorial/HowToDebug.rst) -* If you have any questions on usage, review [FAQ](https://github.com/microsoft/nni/blob/master/docs/en_US/Tutorial/FAQ.rst) first, if there are no relevant issues and answers to your question, try contact NNI dev team and users in [Gitter](https://gitter.im/Microsoft/nni?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) or [File an issue](https://github.com/microsoft/nni/issues/new/choose) on GitHub. -* [Customize your own Tuner](docs/en_US/Tuner/CustomizeTuner.rst) -* [Implement customized TrainingService](docs/en_US/TrainingService/HowToImplementTrainingService.rst) -* [Implement a new NAS trainer on NNI](docs/en_US/NAS/Advanced.rst) -* [Customize your own Advisor](docs/en_US/Tuner/CustomizeAdvisor.rst) - diff --git a/CONTRIBUTING_zh_CN.md b/CONTRIBUTING_zh_CN.md deleted file mode 100644 index 1626a8524e2c98bfa5957c326a22fcce00b1fcdb..0000000000000000000000000000000000000000 --- a/CONTRIBUTING_zh_CN.md +++ /dev/null @@ -1,62 +0,0 @@ -# 贡献代码 - -非常感谢您有兴趣对 NNI 做出贡献! - -除了编写代码外,您还可以通过多种方式参与, 本文档的目的是提供一个如何参与贡献的高层次概述。 - -# 反馈或提问 - -* 在 Github 上创建 [issue](https://github.com/microsoft/nni/issues/new/choose)。 -* 在 [Stack Overflow](https://stackoverflow.com/questions/tagged/nni?sort=Newest&edited=true) 上使用 nni 标签提问。 -* 在 [Gitter](https://gitter.im/Microsoft/nni?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) 中参与讨论。 - -加入聊天组: -| Gitter | | 微信 | -| -------------------------------------------------------------------------------------------------------------- | - | ----------------------------------------------------------------------- | -|  | 或 |  | - - -# 查找现有问题 -在创建新 issue 之前,请在 [open issues](https://github.com/microsoft/nni/issues) 中进行搜索,以查看问题或功能请求是否已经存在。 - -确保已经浏览了 [最热门](https://github.com/microsoft/nni/issues?q=is%3Aopen+is%3Aissue+label%3AFAQ+sort%3Areactions-%2B1-desc) 的功能请求。 - -如果您的问题已经存在,请在下方发表评论或添加[回应](https://github.com/blog/2119-add-reactions-to-pull-requests-issues-and-comments)。 通过回应来代替“+1”评论: - -* 👍 - 赞成 -* 👎 - 反对 - -如果未能找到描述您 Bug 或功能的现有问题,请使用以下指南创建一个新问题。 - -# 编写良好的错误报告或功能请求 -针对每个错误和功能请求提交一个问题, 不要在同一问题中列举多个 Bug 或功能请求。 - -尽可能多地提供您认为与上下文相关的信息(思考问题如果分配给您,您需要什么样的信息来调试它)。 为了让您大致了解哪些信息对开发人员解决问题有帮助,我们为您提供了问题模板。 - -提交问题后,请务必跟进问题并参与讨论。 - -修正 Bug 或实现功能后,请务必关闭此问题。 - -# 贡献修复或示例 - -此项目欢迎任何贡献和建议。 大多数贡献需要您同意参与者许可协议(CLA),来声明您有权并授予我们使用您贡献的权利。 有关详细信息,请访问 https://cla.opensource.microsoft.com。 - -当你提交拉取请求时,CLA 机器人会自动检查你是否需要提供 CLA,并修饰这个拉取请求(例如标签、注释等)。 只需要按照机器人提供的说明进行操作即可。 CLA 只需要同意一次,就能应用到所有的代码仓库上。 - -# 行为准则 - -该项目采用了 [ Microsoft 开源行为准则 ](https://opensource.microsoft.com/codeofconduct/)。 有关详细信息,请参阅[行为守则常见问题解答](https://opensource.microsoft.com/codeofconduct/faq/)或联系 opencode@microsoft.com 咨询问题或评论。 - -# 参与贡献 - -熟悉贡献协议后,即可按照 NNI 开发人员教程,创建第一个 PR =): - -* 推荐新贡献者先从简单的问题开始:['good first issue'](https://github.com/Microsoft/nni/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) 或 ['help-wanted'](https://github.com/microsoft/nni/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)。 -* [NNI 开发环境安装教程](docs/zh_CN/Tutorial/SetupNniDeveloperEnvironment.rst) -* [如何调试](docs/zh_CN/Tutorial/HowToDebug.rst) -* 如果有使用上的问题,可先查看[常见问题解答](https://github.com/microsoft/nni/blob/master/docs/zh_CN/Tutorial/FAQ.rst)。如果没能解决问题,可通过 [Gitter](https://gitter.im/Microsoft/nni?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) 联系 NNI 开发团队或在 GitHub 上 [报告问题](https://github.com/microsoft/nni/issues/new/choose)。 -* [自定义 Tuner](docs/zh_CN/Tuner/CustomizeTuner.rst) -* [实现定制的训练平台](docs/zh_CN/TrainingService/HowToImplementTrainingService.rst) -* [在 NNI 上实现新的 NAS Trainer](docs/zh_CN/NAS/Advanced.rst) -* [自定义 Advisor](docs/zh_CN/Tuner/CustomizeAdvisor.rst) - diff --git a/README.md b/README.md index b17838c96a3b3484ee531aa3605c1b539d704b3e..3be82e3eb302bc6c668dbf78abe820c5e1458045 100644 --- a/README.md +++ b/README.md @@ -1,332 +1,245 @@ -
-
-
+
](https://nni.readthedocs.io/)
-* Those who want to **try different AutoML algorithms** in their training code/model.
-* Those who want to run AutoML trial jobs **in different environments** to speed up search.
-* Researchers and data scientists who want to easily **implement and experiment new AutoML algorithms**, may it be: hyperparameter tuning algorithm, neural architect search algorithm or model compression algorithm.
-* ML Platform owners who want to **support AutoML in their platform**.
+NNI automates feature engineering, neural architecture search, hyperparameter tuning, and model compression for deep learning. Find the latest features, API, examples and tutorials in our **[official documentation](https://nni.readthedocs.io/) ([简体中文版点这里](https://nni.readthedocs.io/zh/stable))**.
-## **What's NEW!** | - | -
- Frameworks & Libraries
-
- |
-
- Algorithms
-
- |
-
- Training Services
-
- |
-
| - Built-in - | -
-
-
-
- |
-
- Hyperparameter Tuning
-
|
-
-
|
-
| - References - | -
-
|
- - - | -- - | -
| + |
+Hyperparameter Tuning
+
+ |
+
+Neural Architecture Search
+
+ |
+
+Model Compression
+
+ |
+
| +Algorithms + | ++ + | +
+
|
++ + | +
| + |
+Supported Frameworks
+
+ |
+
+Training Services
+
+ |
+
+Tutorials
+
+ |
+
| +Supports + | +
+
|
+
+
|
+
+
|
+
-## **Releases and Contributing**
-NNI has a monthly release cycle (major releases). Please let us know if you encounter a bug by [filling an issue](https://github.com/microsoft/nni/issues/new/choose).
-
-We appreciate all contributions. If you are planning to contribute any bug-fixes, please do so without further discussions.
+## Resources
-If you plan to contribute new features, new tuners, new training services, etc. please first open an issue or reuse an exisiting issue, and discuss the feature with us. We will discuss with you on the issue timely or set up conference calls if needed.
+* [NNI Documentation Homepage](https://nni.readthedocs.io/)
+* [NNI Installation Guide](https://nni.readthedocs.io/en/stable/installation.html)
+* [NNI Examples](https://nni.readthedocs.io/en/latest/examples.html)
+* [Python API Reference](https://nni.readthedocs.io/en/latest/reference/python_api.html)
+* [Releases (Change Log)](https://nni.readthedocs.io/en/latest/release.html)
+* [Related Research and Publications](https://nni.readthedocs.io/en/latest/notes/research_publications.html)
+* [Youtube Channel of NNI](https://www.youtube.com/channel/UCKcafm6861B2mnYhPbZHavw)
+* [Bilibili Space of NNI](https://space.bilibili.com/1649051673)
+* [Webinar of Introducing Retiarii: A deep learning exploratory-training framework on NNI](https://note.microsoft.com/MSR-Webinar-Retiarii-Registration-Live.html)
+* [Community Discussions](https://github.com/microsoft/nni/discussions)
-To learn more about making a contribution to NNI, please refer to our [How-to contribution page](https://nni.readthedocs.io/en/stable/contribution.html).
+## Contribution guidelines
-We appreciate all contributions and thank all the contributors!
+If you want to contribute to NNI, be sure to review the [contribution guidelines](https://nni.readthedocs.io/en/stable/notes/contributing.html), which includes instructions of submitting feedbacks, best coding practices, and code of conduct.
-
-
-
| - | -
- 支持的框架和库
-
- |
-
- 算法
-
- |
-
- 训练平台
-
- |
-
| - 内置 - | -
-
-
-
- |
-
- 超参调优
-
|
-
-
|
-
| - 参考 - | -
-
|
- - - | -- - | -
-
-## **发布和贡献**
-
-NNI 有一个月度发布周期(主要发布)。 如果您遇到问题可以通过 [创建 issue](https://github.com/microsoft/nni/issues/new/choose) 来报告。
-
-我们感谢所有的贡献。 我们感谢所有的贡献。 如果您计划提供任何 Bug 修复,请放手去做,不需要任何顾虑。
-
-如果您计划提供新的功能、新的 Tuner 和 新的训练平台等, 请先创建一个新的 issue 或重用现有 issue,并与我们讨论该功能。 我们会及时与您讨论这个问题,如有需要会安排电话会议。
-
-再次感谢所有的贡献者!
-
-再次感谢所有的贡献者!
-
-
-
-## **反馈**
-
-* [在 GitHub 上提交问题](https://github.com/microsoft/nni/issues/new/choose)。
-* 在 [Gitter](https://gitter.im/Microsoft/nni?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) 中参与讨论。
-* NNI 有一个月度发布周期(主要发布)。 如果您遇到问题可以通过 [创建 issue](https://github.com/microsoft/nni/issues/new/choose) 来报告。
-
-加入聊天组:
-
-| Gitter | | 微信 |
-| -------------------------------------------------------------------------------------------------------------- | - | ----------------------------------------------------------------------- |
-|  | 或 |  |
-
-## 测试状态
-
-### 必需
-
-| 类型 | 状态 |
-|:------------:|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
-| Fast test | [](https://msrasrg.visualstudio.com/NNIOpenSource/_build/latest?definitionId=54&branchName=master) |
-| Full linux | [](https://msrasrg.visualstudio.com/NNIOpenSource/_build/latest?definitionId=62&repoName=microsoft%2Fnni&branchName=master) |
-| Full windows | [](https://msrasrg.visualstudio.com/NNIOpenSource/_build/latest?definitionId=63&branchName=master) |
-
-### 训练平台
-
-| 类型 | 状态 |
-|:-------------------------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
-| Remote - linux to linux | [](https://msrasrg.visualstudio.com/NNIOpenSource/_build/latest?definitionId=64&branchName=master) |
-| Remote - linux to windows | [](https://msrasrg.visualstudio.com/NNIOpenSource/_build/latest?definitionId=67&branchName=master) |
-| Remote - windows to linux | [](https://msrasrg.visualstudio.com/NNIOpenSource/_build/latest?definitionId=68&branchName=master) |
-| OpenPAI | [](https://msrasrg.visualstudio.com/NNIOpenSource/_build/latest?definitionId=65&branchName=master) |
-| Frameworkcontroller | [](https://msrasrg.visualstudio.com/NNIOpenSource/_build/latest?definitionId=70&branchName=master) |
-| Kubeflow | [](https://msrasrg.visualstudio.com/NNIOpenSource/_build/latest?definitionId=69&branchName=master) |
-| Hybrid | [](https://msrasrg.visualstudio.com/NNIOpenSource/_build/latest?definitionId=79&branchName=master) |
-| AzureML | [](https://msrasrg.visualstudio.com/NNIOpenSource/_build/latest?definitionId=78&branchName=master) |
-
-## 相关项目
-
-针对开放性和推进最先进的技术,[微软研究院(MSR)](https://www.microsoft.com/en-us/research/group/systems-and-networking-research-group-asia/) 还发布了其他几个开源项目。
-
-* [OpenPAI](https://github.com/Microsoft/pai):作为开源平台,提供了完整的 AI 模型训练和资源管理能力,能轻松扩展,并支持各种规模的私有部署、云和混合环境。
-* [FrameworkController](https://github.com/Microsoft/frameworkcontroller):开源的通用 Kubernetes Pod 控制器,通过单个控制器来编排 Kubernetes 上所有类型的应用。
-* [MMdnn](https://github.com/Microsoft/MMdnn):一个完整、跨框架的解决方案,能够转换、可视化、诊断深度神经网络模型。 MMdnn 中的 "MM" 表示 model management(模型管理),而 "dnn" 是 deep neural network(深度神经网络)的缩写。 MMdnn 中的 "MM" 表示 model management(模型管理),而 "dnn" 是 deep neural network(深度神经网络)的缩写。
-* [SPTAG](https://github.com/Microsoft/SPTAG) : Space Partition Tree And Graph (SPTAG) 是用于大规模向量的最近邻搜索场景的开源库。
-
-我们鼓励研究人员和学生利用这些项目来加速 AI 开发和研究。
-
-## **许可协议**
-
-代码库遵循 [MIT 许可协议](LICENSE)
diff --git a/SECURITY_zh_CN.md b/SECURITY_zh_CN.md
deleted file mode 100644
index bfd7da66aa9b56a490e5590ba3d6503c1a01bf94..0000000000000000000000000000000000000000
--- a/SECURITY_zh_CN.md
+++ /dev/null
@@ -1,41 +0,0 @@
-
-
-## 安全
-
-微软非常重视软件产品和服务的安全性,包括通过我们的 GitHub 组织管理的所有源代码库,其中涵盖 [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin),和 [我们 GitHub 的组织](https://opensource.microsoft.com/)。
-
-如果你在任何微软拥有的资源库中发现了安全漏洞,并且符合 [微软对安全漏洞的定义](https://docs.microsoft.com/en-us/previous-versions/tn-archive/cc751383(v=technet.10)),请按照下文所述向我们报告。
-
-## 报告安全问题
-
-**请不要通过公开的 GitHub 问题报告安全漏洞。**
-
-相反,请向微软安全响应中心(MSRC)报告,链接是 [https://msrc.microsoft.com/create-report](https://msrc.microsoft.com/create-report)。
-
-如果您希望在不登录的情况下提交,请发送电子邮件至 [secure@microsoft.com](mailto:secure@microsoft.com)。 如果可能的话,请用我们的 PGP 密钥对您的信息进行加密;请从以下网站下载该密钥 [微软安全响应中心 PGP 密钥页面](https://www.microsoft.com/en-us/msrc/pgp-key-msrc)。
-
-你应该在24小时内收到回复。 如果由于某些原因你没有收到,请通过电子邮件跟进,以确保我们收到你的原始信息。 其他信息可以在以下网站找到 [microsoft.com/msrc](https://www.microsoft.com/msrc)。
-
-请包括以下所要求的信息(尽可能多地提供),以帮助我们更好地了解可能的问题的性质和范围。
-
- * 问题类型(如缓冲区溢出、SQL 注入、跨站脚本等)
- * 与问题表现有关的源文件的完整路径
- * 受影响的源代码位置(标签/分支/提交或 URL)
- * 重现该问题所需的任何特殊配置
- * 重现该问题的分步骤说明
- * 概念证明或漏洞代码(如果可能的话)
- * 该问题的影响,包括攻击者如何利用该问题
-
-这些信息将帮助我们更快地对你的报告进行分流。
-
-如果您需要报告错误赏金,更完整的报告可有助于获得更高的赏金奖励。 请访问我们的[微软漏洞赏金计划](https://microsoft.com/msrc/bounty)页面,以了解有关我们活动计划的更多详细信息。
-
-## 首选语言
-
-我们希望所有的交流都是用英语进行的。
-
-## 政策
-
-微软遵循[协调漏洞披露](https://www.microsoft.com/en-us/msrc/cvd)的原则。
-
-
diff --git a/dependencies/develop.txt b/dependencies/develop.txt
index 56a4dcadc743eef8ae974a134363cee450d471b9..0e87993cbb72501b803dc9884eca10cc7ed8a615 100644
--- a/dependencies/develop.txt
+++ b/dependencies/develop.txt
@@ -2,15 +2,20 @@ coverage
cython
flake8
ipython
-jupyterlab
+jupyter
+jupyterlab == 3.0.9
nbsphinx
pylint
+pyright
pytest
pytest-azurepipelines
pytest-cov
rstcheck
-sphinx
+sphinx >= 4.5
sphinx-argparse-nni >= 0.4.0
+sphinx-copybutton
sphinx-gallery
+sphinx-intl
+sphinx-tabs
sphinxcontrib-bibtex
-git+https://github.com/bashtage/sphinx-material.git
+git+https://github.com/bashtage/sphinx-material@6e0ef82#egg=sphinx_material
diff --git a/dependencies/recommended.txt b/dependencies/recommended.txt
index 572dac3489c01db7aec6c4c4b16e6ff5c85a9211..2459808c5a086b362dfcf9190def67909eb73639 100644
--- a/dependencies/recommended.txt
+++ b/dependencies/recommended.txt
@@ -7,8 +7,9 @@ torch == 1.10.0+cpu ; sys_platform != "darwin"
torch == 1.10.0 ; sys_platform == "darwin"
torchvision == 0.11.1+cpu ; sys_platform != "darwin"
torchvision == 0.11.1 ; sys_platform == "darwin"
-pytorch-lightning >= 1.5.0
+pytorch-lightning >= 1.5.0, < 1.6.0
torchmetrics
+lightgbm
onnx
peewee
graphviz
diff --git a/dependencies/recommended_gpu.txt b/dependencies/recommended_gpu.txt
index 54f75b0661546d241686f1b2a0c4a27076bbbec8..f9a5b6d8f56262cd76019b59fd2fca90774f5999 100644
--- a/dependencies/recommended_gpu.txt
+++ b/dependencies/recommended_gpu.txt
@@ -4,7 +4,8 @@
tensorflow
torch == 1.10.0+cu111
torchvision == 0.11.1+cu111
-pytorch-lightning >= 1.5.0
+pytorch-lightning >= 1.5.0, < 1.6.0
+lightgbm
onnx
peewee
graphviz
diff --git a/dependencies/recommended_legacy.txt b/dependencies/recommended_legacy.txt
index 5c5b39ee61f298fac39ef0c805410bf8dd95105f..da4cacb06f440e9e5aa99bc45ff065fdd2691434 100644
--- a/dependencies/recommended_legacy.txt
+++ b/dependencies/recommended_legacy.txt
@@ -7,6 +7,7 @@ torchvision == 0.8.2+cpu
pytorch-lightning
torchmetrics
+lightgbm
onnx
peewee
graphviz
diff --git a/dependencies/required.txt b/dependencies/required.txt
index 2ce30c9cd9e0aded06f8acab7e3c81df59466bdb..bb8d0cc8b9e2b9fd9b93dcb1652b3864d3dec8d3 100644
--- a/dependencies/required.txt
+++ b/dependencies/required.txt
@@ -6,6 +6,7 @@ hyperopt == 0.1.2
json_tricks >= 3.15.5
numpy < 1.22 ; python_version < "3.8"
numpy ; python_version >= "3.8"
+packaging
pandas
prettytable
psutil
@@ -18,5 +19,5 @@ scikit-learn >= 0.24.1
scipy < 1.8 ; python_version < "3.8"
scipy ; python_version >= "3.8"
typeguard
-typing_extensions ; python_version < "3.8"
+typing_extensions >= 4.0.0 ; python_version < "3.8"
websockets >= 10.1
diff --git a/docs/.gitignore b/docs/.gitignore
index 20b5bd428820e468305c3bb80a62d8e23fe4843c..522de2ff58d13b94c70e6d3cecd9064ea0a3fd56 100644
--- a/docs/.gitignore
+++ b/docs/.gitignore
@@ -2,3 +2,12 @@ build/
# legacy build
_build/
+
+# ignored copied rst in tutorials
+/source/tutorials/**/cp_*.rst
+
+# auto-generated reference table
+_modules/
+
+# Machine-style translation files
+*.mo
diff --git a/docs/Makefile b/docs/Makefile
index ba501f6f5b1bfd30093a73f5fc04b85122e604a4..1d14ccfe792908ba28451f100e5d0b16a59c9b3d 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -11,6 +11,11 @@ BUILDDIR = build
help:
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+# Build message catelogs for translation
+i18n:
+ @$(SPHINXBUILD) -M getpartialtext "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+ sphinx-intl update -p "$(BUILDDIR)/getpartialtext" -d "$(SOURCEDIR)/locales" -l zh
+
.PHONY: help Makefile
# Catch-all target: route all unknown targets to Sphinx using the new
diff --git a/docs/source/Assessor/CurvefittingAssessor.rst b/docs/_removed/CurvefittingAssessor.rst
similarity index 100%
rename from docs/source/Assessor/CurvefittingAssessor.rst
rename to docs/_removed/CurvefittingAssessor.rst
diff --git a/docs/source/Tutorial/HowToDebug.rst b/docs/_removed/HowToDebug.rst
similarity index 100%
rename from docs/source/Tutorial/HowToDebug.rst
rename to docs/_removed/HowToDebug.rst
diff --git a/docs/source/Tutorial/HowToLaunchFromPython.rst b/docs/_removed/HowToLaunchFromPython.rst
similarity index 100%
rename from docs/source/Tutorial/HowToLaunchFromPython.rst
rename to docs/_removed/HowToLaunchFromPython.rst
diff --git a/docs/source/Tutorial/HowToUseDocker.rst b/docs/_removed/HowToUseDocker.rst
similarity index 100%
rename from docs/source/Tutorial/HowToUseDocker.rst
rename to docs/_removed/HowToUseDocker.rst
diff --git a/docs/source/Tutorial/InstallationLinux.rst b/docs/_removed/InstallationLinux.rst
similarity index 100%
rename from docs/source/Tutorial/InstallationLinux.rst
rename to docs/_removed/InstallationLinux.rst
diff --git a/docs/source/Tutorial/InstallationLinux_zh.rst b/docs/_removed/InstallationLinux_zh.rst
similarity index 100%
rename from docs/source/Tutorial/InstallationLinux_zh.rst
rename to docs/_removed/InstallationLinux_zh.rst
diff --git a/docs/source/Tutorial/InstallationWin.rst b/docs/_removed/InstallationWin.rst
similarity index 100%
rename from docs/source/Tutorial/InstallationWin.rst
rename to docs/_removed/InstallationWin.rst
diff --git a/docs/source/Tutorial/InstallationWin_zh.rst b/docs/_removed/InstallationWin_zh.rst
similarity index 100%
rename from docs/source/Tutorial/InstallationWin_zh.rst
rename to docs/_removed/InstallationWin_zh.rst
diff --git a/docs/source/Release_v1.0.md b/docs/_removed/Release_v1.0.md
similarity index 100%
rename from docs/source/Release_v1.0.md
rename to docs/_removed/Release_v1.0.md
diff --git a/docs/source/SupportedFramework_Library.rst b/docs/_removed/SupportedFramework_Library.rst
similarity index 100%
rename from docs/source/SupportedFramework_Library.rst
rename to docs/_removed/SupportedFramework_Library.rst
diff --git a/docs/source/TrainingService/AMLMode.rst b/docs/_removed/TrainingService/AMLMode.rst
similarity index 100%
rename from docs/source/TrainingService/AMLMode.rst
rename to docs/_removed/TrainingService/AMLMode.rst
diff --git a/docs/source/TrainingService/FrameworkControllerMode.rst b/docs/_removed/TrainingService/FrameworkControllerMode.rst
similarity index 100%
rename from docs/source/TrainingService/FrameworkControllerMode.rst
rename to docs/_removed/TrainingService/FrameworkControllerMode.rst
diff --git a/docs/source/TrainingService/HybridMode.rst b/docs/_removed/TrainingService/HybridMode.rst
similarity index 100%
rename from docs/source/TrainingService/HybridMode.rst
rename to docs/_removed/TrainingService/HybridMode.rst
diff --git a/docs/source/TrainingService/KubeflowMode.rst b/docs/_removed/TrainingService/KubeflowMode.rst
similarity index 100%
rename from docs/source/TrainingService/KubeflowMode.rst
rename to docs/_removed/TrainingService/KubeflowMode.rst
diff --git a/docs/source/TrainingService/Overview.rst b/docs/_removed/TrainingService/Overview.rst
similarity index 100%
rename from docs/source/TrainingService/Overview.rst
rename to docs/_removed/TrainingService/Overview.rst
diff --git a/docs/source/TrainingService/PaiMode.rst b/docs/_removed/TrainingService/PaiMode.rst
similarity index 100%
rename from docs/source/TrainingService/PaiMode.rst
rename to docs/_removed/TrainingService/PaiMode.rst
diff --git a/docs/source/TrainingService/RemoteMachineMode.rst b/docs/_removed/TrainingService/RemoteMachineMode.rst
similarity index 100%
rename from docs/source/TrainingService/RemoteMachineMode.rst
rename to docs/_removed/TrainingService/RemoteMachineMode.rst
diff --git a/docs/source/TrialExample/Cifar10Examples.rst b/docs/_removed/TrialExample/Cifar10Examples.rst
similarity index 100%
rename from docs/source/TrialExample/Cifar10Examples.rst
rename to docs/_removed/TrialExample/Cifar10Examples.rst
diff --git a/docs/source/TrialExample/GbdtExample.rst b/docs/_removed/TrialExample/GbdtExample.rst
similarity index 100%
rename from docs/source/TrialExample/GbdtExample.rst
rename to docs/_removed/TrialExample/GbdtExample.rst
diff --git a/docs/source/TrialExample/MnistExamples.rst b/docs/_removed/TrialExample/MnistExamples.rst
similarity index 100%
rename from docs/source/TrialExample/MnistExamples.rst
rename to docs/_removed/TrialExample/MnistExamples.rst
diff --git a/docs/source/TrialExample/Pix2pixExample.rst b/docs/_removed/TrialExample/Pix2pixExample.rst
similarity index 100%
rename from docs/source/TrialExample/Pix2pixExample.rst
rename to docs/_removed/TrialExample/Pix2pixExample.rst
diff --git a/docs/source/TrialExample/SklearnExamples.rst b/docs/_removed/TrialExample/SklearnExamples.rst
similarity index 100%
rename from docs/source/TrialExample/SklearnExamples.rst
rename to docs/_removed/TrialExample/SklearnExamples.rst
diff --git a/docs/source/TrialExample/Trials.rst b/docs/_removed/Trials.rst
similarity index 100%
rename from docs/source/TrialExample/Trials.rst
rename to docs/_removed/Trials.rst
diff --git a/docs/source/Tuner/BohbAdvisor.rst b/docs/_removed/Tuner/BohbAdvisor.rst
similarity index 100%
rename from docs/source/Tuner/BohbAdvisor.rst
rename to docs/_removed/Tuner/BohbAdvisor.rst
diff --git a/docs/source/Tuner/CustomizeAdvisor.rst b/docs/_removed/Tuner/CustomizeAdvisor.rst
similarity index 100%
rename from docs/source/Tuner/CustomizeAdvisor.rst
rename to docs/_removed/Tuner/CustomizeAdvisor.rst
diff --git a/docs/source/Tuner/DngoTuner.rst b/docs/_removed/Tuner/DngoTuner.rst
similarity index 100%
rename from docs/source/Tuner/DngoTuner.rst
rename to docs/_removed/Tuner/DngoTuner.rst
diff --git a/docs/source/Tuner/EvolutionTuner.rst b/docs/_removed/Tuner/EvolutionTuner.rst
similarity index 100%
rename from docs/source/Tuner/EvolutionTuner.rst
rename to docs/_removed/Tuner/EvolutionTuner.rst
diff --git a/docs/source/Tuner/GPTuner.rst b/docs/_removed/Tuner/GPTuner.rst
similarity index 100%
rename from docs/source/Tuner/GPTuner.rst
rename to docs/_removed/Tuner/GPTuner.rst
diff --git a/docs/source/Tuner/HyperbandAdvisor.rst b/docs/_removed/Tuner/HyperbandAdvisor.rst
similarity index 100%
rename from docs/source/Tuner/HyperbandAdvisor.rst
rename to docs/_removed/Tuner/HyperbandAdvisor.rst
diff --git a/docs/source/Tuner/MetisTuner.rst b/docs/_removed/Tuner/MetisTuner.rst
similarity index 100%
rename from docs/source/Tuner/MetisTuner.rst
rename to docs/_removed/Tuner/MetisTuner.rst
diff --git a/docs/source/Tuner/PBTTuner.rst b/docs/_removed/Tuner/PBTTuner.rst
similarity index 100%
rename from docs/source/Tuner/PBTTuner.rst
rename to docs/_removed/Tuner/PBTTuner.rst
diff --git a/docs/source/Tuner/SmacTuner.rst b/docs/_removed/Tuner/SmacTuner.rst
similarity index 100%
rename from docs/source/Tuner/SmacTuner.rst
rename to docs/_removed/Tuner/SmacTuner.rst
diff --git a/docs/source/Tutorial/NNSpider.md b/docs/_removed/Tutorial/NNSpider.md
similarity index 100%
rename from docs/source/Tutorial/NNSpider.md
rename to docs/_removed/Tutorial/NNSpider.md
diff --git a/docs/source/Tutorial/python_api_connect.ipynb b/docs/_removed/Tutorial/python_api_connect.ipynb
similarity index 100%
rename from docs/source/Tutorial/python_api_connect.ipynb
rename to docs/_removed/Tutorial/python_api_connect.ipynb
diff --git a/docs/source/Tutorial/python_api_start.ipynb b/docs/_removed/Tutorial/python_api_start.ipynb
similarity index 100%
rename from docs/source/Tutorial/python_api_start.ipynb
rename to docs/_removed/Tutorial/python_api_start.ipynb
diff --git a/docs/source/Tutorial/WebUI.rst b/docs/_removed/WebUI.rst
similarity index 100%
rename from docs/source/Tutorial/WebUI.rst
rename to docs/_removed/WebUI.rst
diff --git a/docs/source/Tutorial/FAQ.rst b/docs/_removed/faq.rst
similarity index 100%
rename from docs/source/Tutorial/FAQ.rst
rename to docs/_removed/faq.rst
diff --git a/docs/_removed/installation.rst b/docs/_removed/installation.rst
new file mode 100644
index 0000000000000000000000000000000000000000..5688b3b4c832cb889d91e32b11fe1af9e7e9f2d0
--- /dev/null
+++ b/docs/_removed/installation.rst
@@ -0,0 +1,12 @@
+############
+Installation
+############
+
+Currently we support installation on Linux, Mac and Windows. We also allow you to use docker.
+
+.. toctree::
+ :maxdepth: 2
+
+ Linux & Mac {tags}
""" -CARD_TEMPLATE = """ +CARD_HEADER = """ .. raw:: html