-
Notifications
You must be signed in to change notification settings - Fork 1.8k
Update readme doc link #3482
Update readme doc link #3482
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Please change all links of readthedocs to the stable
version, because the latest
version is synchronized with the master branch, so users may see our unreleased features' docs and feel confused.
README.md
Outdated
@@ -237,15 +237,15 @@ Windows | |||
python -m pip install --upgrade nni | |||
``` | |||
|
|||
If you want to try latest code, please [install NNI](https://nni.readthedocs.io/en/latest/installation.html) from source code. | |||
If you want to try stable code, please [install NNI](https://nni.readthedocs.io/en/stable/installation.html) from source code. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
should not be "stable"
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
i mean the first "stable" in this line
docs/en_US/Compression/Overview.rst
Outdated
@@ -14,7 +14,8 @@ NNI provides a model compression toolkit to help user compress and speed up thei | |||
* Provide friendly and easy-to-use compression utilities for users to dive into the compression process and results. | |||
* Concise interface for users to customize their own compression algorithms. | |||
|
|||
*Note that the interface and APIs are unified for both PyTorch and TensorFlow, currently only PyTorch version has been supported, TensorFlow version will be supported in future.* | |||
*Note that NNI compresses the model through a simulation process. To obtain a truly compact model, users should conduct model speedup. The interface and APIs are unified for both PyTorch and TensorFlow, currently only PyTorch version has been supported, TensorFlow version will be supported in future.* |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
better to add a link for "conduct model speedup"
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"*Note" -> ".. Note:: "
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks, fix it.
@@ -23,24 +23,29 @@ There are different keys in a ``dict``. Some of them are common keys supported b | |||
|
|||
Some other keys are often specific to a certain algorithm, users can refer to `pruning algorithms <./Pruner.rst>`__ and `quantization algorithms <./Quantizer.rst>`__ for the keys allowed by each algorithm. | |||
|
|||
A simple example of configuration is shown below: | |||
To prune all ``Conv2d`` layers with the sparsity of 0.6, the configuration can be write as: | |||
.. code-block:: python |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Please double-check the rendering results.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for point out that. Please review the latest version.
README.md
Outdated
@@ -5,18 +5,18 @@ | |||
----------- | |||
|
|||
[![MIT licensed](https://img.shields.io/badge/license-MIT-brightgreen.svg)](LICENSE) | |||
[![Build Status](https://msrasrg.visualstudio.com/NNIOpenSource/_apis/build/status/full%20test%20-%20linux?branchName=master)](https://msrasrg.visualstudio.com/NNIOpenSource/_build/latest?definitionId=62&branchName=master) | |||
[![Build Status](https://msrasrg.visualstudio.com/NNIOpenSource/_apis/build/status/full%20test%20-%20linux?branchName=master)](https://msrasrg.visualstudio.com/NNIOpenSource/_build/stable?definitionId=62&branchName=master) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Broken link, only readthedocs links need to be changed.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks, fix it.
README.md
Outdated
@@ -297,7 +297,7 @@ You can use these commands to get more information about the experiment | |||
----------------------------------------------------------------------- | |||
``` | |||
|
|||
* Open the `Web UI url` in your browser, you can view detail information of the experiment and all the submitted trial jobs as shown below. [Here](docs/en_US/Tutorial/WebUI.rst) are more Web UI pages. | |||
* Open the `Web UI url` in your browser, you can view detail information of the experiment and all the submitted trial jobs as shown below. [Here](https://nni.readthedocs.io/en/stable/Tutorial/WebUI.html) are more Web UI pages. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Recommend using 'detailed information'.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks, fix it.
docs/en_US/Compression/Overview.rst
Outdated
@@ -14,7 +14,9 @@ NNI provides a model compression toolkit to help user compress and speed up thei | |||
* Provide friendly and easy-to-use compression utilities for users to dive into the compression process and results. | |||
* Concise interface for users to customize their own compression algorithms. | |||
|
|||
*Note that the interface and APIs are unified for both PyTorch and TensorFlow, currently only PyTorch version has been supported, TensorFlow version will be supported in future.* | |||
.. note:: | |||
NNI compresses the model through a simulation process. To obtain a truly compact model, users should conduct `model speedup <./ModelSpeedup.rst>`__. The interface and APIs are unified for both PyTorch and TensorFlow, currently only PyTorch version has been supported, TensorFlow version will be supported in future. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Since NNI compression algorithms are not meant to compress model while NNI speedup tool can truly compress model and reduce latency . I think 'NNI compression algorithms simulate the the process of pruning and quantization without truly compressing model and reducing latency.' might be more appropriate at the beginning of this paragraph.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks, added.
docs/en_US/Compression/Tutorial.rst
Outdated
* **op_names**\ : This is to specify by name what operations to be compressed. If this field is omitted, operations will not be filtered by it. | ||
* **exclude**\ : Default is False. If this field is True, it means the operations with specified types and names will be excluded from the compression. | ||
|
||
Some other keys are often specific to a certain algorithm, users can refer to `pruning algorithms <./Pruner.rst>`__ and `quantization algorithms <./Quantizer.rst>`__ for the keys allowed by each algorithm. | ||
|
||
A simple example of configuration is shown below: | ||
To prune all ``Conv2d`` layers with the sparsity of 0.6, the configuration can be write as: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
write -> written
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Fix it.
docs/en_US/Compression/Tutorial.rst
Outdated
'op_types': ['Conv2d'] | ||
}] | ||
|
||
To control the sparsity of specific layers, the configuration can be writed as: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
write -> written
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Fix it.
No description provided.