-
Notifications
You must be signed in to change notification settings - Fork 1.8k
Port markdown docs to rst and introduce "githublink" #3107
Conversation
Let's do an investigation of Chinese docs through PR #3154 first. |
**y** (array-like, require) - The target values (class labels in classification, real numbers in regression) which shape = [n_samples]. | ||
|
||
* | ||
**lgb_params** (dict, require) - The parameters for lightgbm model. The detail you could reference `here <https://lightgbm.readthedocs.io/en/latest/Parameters.html>`__ |
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.
Two underscores?
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.
Use only one underscore will produce warnings. I don't fully understand this though.
|
||
pruner.export_model(model_path='model.pth') | ||
|
||
``mask_dict`` and pruned model in ``onnx`` format(\ ``input_shape`` need to be specified) can also be exported like this: |
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.
Backslash?
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.
Blackslash is for whitespace. It's converted from markdown. Maybe we can get rid of this later.
docs/en_US/Tuner/BuiltinTuner.rst
Outdated
|
||
* - Tuner | ||
- Brief Introduction of Algorithm | ||
* - `**TPE** <#TPE>`__ |
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.
There's something wrong with the bold font.
Currently, we support the following algorithms: | ||
|
||
.. list-table:: | ||
:header-rows: 1 |
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.
Maybe we could add :widths: auto
docs/en_US/TrialExample/Trials.rst
Outdated
|
||
In the YAML configure file, you need to set *useAnnotation* to true to enable NNI annotation: | ||
|
||
.. code-block:::: bash |
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.
It should be two colons.
docs/en_US/Tuner/BuiltinTuner.rst
Outdated
Usage of Built-in Tuners | ||
------------------------ | ||
|
||
Using a built-in tuner provided by the NNI SDK requires one to declare the **builtinTunerName** and** classArgs** in the ``config.yml`` file. In this part, we will introduce each tuner along with information about usage and suggested scenarios, classArg requirements, and an example configuration. |
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.
blank space
docs/en_US/Tuner/BuiltinTuner.rst
Outdated
classArgs: | ||
optimize_mode: maximize | ||
|
||
Note that, to use this tuner, your trial code should be modified accordingly, please refer to `the document of PBTTuner <./PBTTuner>`__ for details. |
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.
The link is broken.
docs/en_US/Tuner/BuiltinTuner.rst
Outdated
Built-in Tuner Name: **PPOTuner** | ||
|
||
|
||
Note that the only acceptable types within the search space are ``layer_choice`` and ``input_choice``. For ``input_choice``\ , ``n_chosen`` can only be 0, 1, or [0, 1]. Note, the search space file for NAS is usually automatically generated through the command `\ ``nnictl ss_gen`` <../Tutorial/Nnictl>`__. |
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.
the command \ ``nnictl ss_gen`` <../Tutorial/Nnictl>
does not display properly.
docs/en_US/Compression/Overview.rst
Outdated
|
||
* - Name | ||
- Brief Introduction of Algorithm | ||
* - `Level Pruner <https://nni.readthedocs.io/en/latest/Compression/Pruner.html#level-pruner>`__ |
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.
Absolute path? Not just in this doc
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 we delete the folderarchive_en_US
?
Let's keep it and delete it before release. |
In this pull request, all the docs will be converted to rst. I will also introduce "githublink". Docs will now be automatically linked to the code/directory that is in the corresponding commit.
Still a few problems to solve:
FIXME
.