@@ -82,73 +71,42 @@ You can find a large collection of tutorials, examples and real-world applicatio
-# Documentation
-
-TensorLayer has extensive documentation for both beginners and professionals. The documentation is available in
-both English and Chinese. Please click the following icons to find the documents you need:
-
-[](https://tensorlayer.readthedocs.io/)
-[](https://tensorlayercn.readthedocs.io/)
-[](http://www.broadview.com.cn/book/5059/)
-
-If you want to try the experimental features on the the master branch, you can find the latest document
-[here](https://tensorlayer.readthedocs.io/en/latest/).
-
-# Install
+# Getting Start
-For latest code for TensorLayer 2.0, please build from the source. TensorLayer 2.0 has pre-requisites including TensorFlow 2, numpy, and others. For GPU support, CUDA and cuDNN are required.
+TensorLayer 2.0 relies on TensorFlow, numpy, and others. To use GPUs, CUDA and cuDNN are required.
Install TensorFlow:
```bash
-pip3 install tensorflow-gpu==2.0.0-beta1 # specific version (YOU SHOULD INSTALL THIS ONE NOW)
-pip3 install tensorflow-gpu # GPU version
+pip3 install tensorflow-gpu==2.0.0-rc1 # TensorFlow GPU (version 2.0 RC1)
pip3 install tensorflow # CPU version
```
-Install the stable version of TensorLayer:
+Install the stable release of TensorLayer:
```bash
pip3 install tensorlayer
```
-Install the latest version of TensorLayer:
+Install the unstable development version of TensorLayer:
```bash
pip3 install git+https://github.com/tensorlayer/tensorlayer.git
-or
-pip3 install https://github.com/tensorlayer/tensorlayer/archive/master.zip
-```
-
-For developers, you should clone the folder to your local machine and put it along with your project scripts.
-
-```bash
-git clone https://github.com/tensorlayer/tensorlayer.git
```
-If you want install TensorLayer 1.X, the simplest way to install TensorLayer 1.X is to use the **Py**thon **P**ackage **I**ndex (PyPI):
-
+If you want to install the additional dependencies, you can also run
```bash
-# for last stable version of TensorLayer 1.X
-pip3 install --upgrade tensorlayer==1.X
-
-# for latest release candidate of TensorLayer 1.X
-pip3 install --upgrade --pre tensorlayer
-
-# if you want to install the additional dependencies, you can also run
pip3 install --upgrade tensorlayer[all] # all additional dependencies
pip3 install --upgrade tensorlayer[extra] # only the `extra` dependencies
pip3 install --upgrade tensorlayer[contrib_loggers] # only the `contrib_loggers` dependencies
```
-
-# Contribute
+# Performance Benchmark
+
+The following table shows the training speeds of [VGG16](http://www.robots.ox.ac.uk/~vgg/research/very_deep/) using TensorLayer and native TensorFlow on a TITAN Xp.
+
+| Mode | Lib | Data Format | Max GPU Memory Usage(MB) |Max CPU Memory Usage(MB) | Avg CPU Memory Usage(MB) | Runtime (sec) |
+| :-------: | :-------------: | :-----------: | :-----------------: | :-----------------: | :-----------------: | :-----------: |
+| AutoGraph | TensorFlow 2.0 | channel last | 11833 | 2161 | 2136 | 74 |
+| | TensorLayer 2.0 | channel last | 11833 | 2187 | 2169 | 76 |
+| Graph | Keras | channel last | 8677 | 2580 | 2576 | 101 |
+| Eager | TensorFlow 2.0 | channel last | 8723 | 2052 | 2024 | 97 |
+| | TensorLayer 2.0 | channel last | 8723 | 2010 | 2007 | 95 |
+
+# Getting Involved
Please read the [Contributor Guideline](CONTRIBUTING.md) before submitting your PRs.
-# Cite
-If you use TensorLayer for any projects, please cite this paper:
+We suggest users to report bugs using Github issues. Users can also discuss how to use TensorLayer in the following slack channel.
+
+