Docs improvement: configurations and more (#1823)

* docs improvement

* docs improvement

* docs improvement

* docs improvement

* docs improvement

* docs improvement

* docs improvement

* docs improvement

* docs improvement

* update

* update

docs/en_US/TrainingService/RemoteMachineMode.md

@@ -16,9 +16,9 @@ Install NNI on each of your machines following the install guide [here](../Tutor
 
 ## Run an experiment
 
-Install NNI on another machine which has network accessibility to those three machines above, or you can just use any machine above to run nnictl command line tool.
+Install NNI on another machine which has network accessibility to those three machines above, or you can just run `nnictl` on any one of the three to launch the experiment.
 
-We use `examples/trials/mnist-annotation` as an example here. `cat ~/nni/examples/trials/mnist-annotation/config_remote.yml` to see the detailed configuration file:
+We use `examples/trials/mnist-annotation` as an example here. Shown here is `examples/trials/mnist-annotation/config_remote.yml`:
 
 ```yaml
 authorName: default
@@ -57,24 +57,15 @@ machineList:
     username: bob
     passwd: bob123
 ```
-You can use different systems to run experiments on the remote machine.
-#### Linux and MacOS
-Simply filling the `machineList` section and then run:
 
-```bash
-nnictl create --config ~/nni/examples/trials/mnist-annotation/config_remote.yml
-```
-
-to start the experiment.
-
-#### Windows
-Simply filling the `machineList` section and then run:
+Files in `codeDir` will be automatically uploaded to the remote machine. You can run NNI on different operating systems (Windows, Linux, MacOS) to spawn experiments on the remote machines (only Linux allowed):
 
 ```bash
-nnictl create --config %userprofile%\nni\examples\trials\mnist-annotation\config_remote.yml
+nnictl create --config examples/trials/mnist-annotation/config_remote.yml
 ```
 
-to start the experiment.
+You can also use public/private key pairs instead of username/password for authentication. For advanced usages, please refer to [Experiment Config Reference](../Tutorial/ExperimentConfig.md).
+
+## Version check
 
-## version check
-NNI support version check feature in since version 0.6, [refer](PaiMode.md)
\ No newline at end of file
+NNI support version check feature in since version 0.6, [reference](PaiMode.md).
\ No newline at end of file

docs/en_US/Tutorial/FAQ.md

@@ -32,9 +32,17 @@ Config the network mode to bridge mode or other mode that could make virtual mac
 ### Could not open webUI link
 Unable to open the WebUI may have the following reasons:
 
-* http://127.0.0.1, http://172.17.0.1 and http://10.0.0.15 are referred to localhost, if you start your experiment on the server or remote machine. You can replace the IP to your server IP to view the WebUI, like http://[your_server_ip]:8080
+* `http://127.0.0.1`, `http://172.17.0.1` and `http://10.0.0.15` are referred to localhost, if you start your experiment on the server or remote machine. You can replace the IP to your server IP to view the WebUI, like `http://[your_server_ip]:8080`
 * If you still can't see the WebUI after you use the server IP, you can check the proxy and the firewall of your machine. Or use the browser on the machine where you start your NNI experiment.
-* Another reason may be your experiment is failed and NNI may fail to get the experiment information. You can check the log of NNIManager in the following directory: ~/nni/experiment/[your_experiment_id] /log/nnimanager.log
+* Another reason may be your experiment is failed and NNI may fail to get the experiment information. You can check the log of NNIManager in the following directory: `~/nni/experiment/[your_experiment_id]` `/log/nnimanager.log`
+
+### Restful server start failed
+
+Probably it's a problem with your network config. Here is a checklist.
+
+* You might need to link `127.0.0.1` with `localhost`. Add a line `127.0.0.1 localhost` to `/etc/hosts`.
+* It's also possible that you have set some proxy config. Check your environment for variables like `HTTP_PROXY` or `HTTPS_PROXY` and unset if they are set.
+
 
 ### NNI on Windows problems
 Please refer to [NNI on Windows](NniOnWindows.md)

docs/en_US/Tutorial/Installation.md

 # Installation of NNI
 
-Currently we support installation on Linux, Mac and Windows(local, remote and pai mode).
+Currently we support installation on Linux, Mac and Windows.
 
 ## **Installation on Linux & Mac**
 

docs/en_US/Tutorial/NniOnWindows.md

 # NNI on Windows (experimental feature)
 
-Currently we support local, remote and pai mode on Windows. Windows 10.1809 is well tested and recommended.
+Running NNI on Windows is an experimental feature. Windows 10.1809 is well tested and recommended.
 
 ## **Installation on Windows**
 
@@ -41,6 +41,9 @@ Make sure C++ 14.0 compiler installed then try to run `nnictl package install --
 ### Not supported tuner on Windows
 SMAC is not supported currently, the specific reason can be referred to this [GitHub issue](https://github.com/automl/SMAC3/issues/483).
 
+### Use a Windows server as a remote worker
+Currently you can't.
+
 Note:
 
 * If there is any error like `Segmentation fault`, please refer to [FAQ](FAQ.md)