From 79548626fe26ba33f9771e6645f0b683f1796af4 Mon Sep 17 00:00:00 2001 From: Chris Elion Date: Tue, 11 Feb 2020 16:02:05 -0800 Subject: [PATCH 1/5] landing page links to latest_release docs --- README.md | 25 +++++++++---------------- docs/Readme.md | 12 ++++++++++++ 2 files changed, 21 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index 6678c13f10..4149a1f3b3 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ # Unity ML-Agents Toolkit (Beta) -[![docs badge](https://img.shields.io/badge/docs-reference-blue.svg)](docs/Readme.md) +[![docs badge](https://img.shields.io/badge/docs-reference-blue.svg)](https://github.com/Unity-Technologies/ml-agents/tree/latest_release/docs/) [![license badge](https://img.shields.io/badge/license-Apache--2.0-green.svg)](LICENSE) ([latest release](https://github.com/Unity-Technologies/ml-agents/releases/tag/latest_release)) @@ -28,8 +28,12 @@ developer communities. * Unity environment control from Python * 10+ sample Unity environments -* Two deep reinforcement learning algorithms, [Proximal Policy Optimization](docs/Training-PPO.md) (PPO) and [Soft Actor-Critic](docs/Training-SAC.md) (SAC) +* Two deep reinforcement learning algorithms, +[Proximal Policy Optimization](https://github.com/Unity-Technologies/ml-agents/tree/latest_release/docs/Training-PPO.md) + (PPO) and [Soft Actor-Critic](https://github.com/Unity-Technologies/ml-agents/tree/latest_release/docs/Training-SAC.md) + (SAC) * Support for multiple environment configurations and training scenarios +* Self-play mechanism for training agents in adversarial scenarios * Train memory-enhanced agents using deep reinforcement learning * Easily definable Curriculum Learning and Generalization scenarios * Built-in support for Imitation Learning @@ -43,7 +47,7 @@ developer communities. ## Documentation * For more information, in addition to installation and usage instructions, see - our [documentation home](docs/Readme.md). + the [documentation for the latest release](https://github.com/Unity-Technologies/ml-agents/tree/latest_release/docs/Readme.md). * If you are a researcher interested in a discussion of Unity as an AI platform, see a pre-print of our [reference paper on Unity and the ML-Agents Toolkit](https://arxiv.org/abs/1809.02627). Also, see below for instructions on citing this paper. * If you have used an earlier version of the ML-Agents toolkit, we strongly recommend our [guide on migrating from earlier versions](docs/Migrating.md). @@ -83,23 +87,12 @@ and make sure to include as much detail as possible. If you run into any other problems using the ML-Agents toolkit, or have a specific feature requests, please [submit a GitHub issue](https://github.com/Unity-Technologies/ml-agents/issues). -Your opinion matters a great deal to us. Only by hearing your thoughts on the Unity ML-Agents Toolkit can we continue to improve and grow. Please take a few minutes to [let us know about it](https://github.com/Unity-Technologies/ml-agents/issues/1454). +Your opinion matters a great deal to us. Only by hearing your thoughts on the Unity ML-Agents Toolkit can we continue +to improve and grow. Please take a few minutes to [let us know about it](https://github.com/Unity-Technologies/ml-agents/issues/1454). For any other questions or feedback, connect directly with the ML-Agents team at ml-agents@unity3d.com. -## Translations - -To make the Unity ML-Agents toolkit accessible to the global research and -Unity developer communities, we're attempting to create and maintain -translations of our documentation. We've started with translating a subset -of the documentation to one language (Chinese), but we hope to continue -translating more pages and to other languages. Consequently, -we welcome any enhancements and improvements from the community. - -* [Chinese](docs/localized/zh-CN/) -* [Korean](docs/localized/KR/) - ## License [Apache License 2.0](LICENSE) diff --git a/docs/Readme.md b/docs/Readme.md index 546860a506..adbdaca9bf 100644 --- a/docs/Readme.md +++ b/docs/Readme.md @@ -60,6 +60,18 @@ * [How to use the Python API](Python-API.md) * [Wrapping Learning Environment as a Gym (+Baselines/Dopamine Integration)](../gym-unity/README.md) +## Translations + +To make the Unity ML-Agents toolkit accessible to the global research and +Unity developer communities, we're attempting to create and maintain +translations of our documentation. We've started with translating a subset +of the documentation to one language (Chinese), but we hope to continue +translating more pages and to other languages. Consequently, +we welcome any enhancements and improvements from the community. + +* [Chinese](docs/localized/zh-CN/) +* [Korean](docs/localized/KR/) + ## Deprecated Docs We no longer use them ourselves and so they may not be up-to-date. We've decided to keep them up just in case they are helpful to you. From 15d8423efbb775f760e3fea240f774e36cae9b9c Mon Sep 17 00:00:00 2001 From: Chris Elion Date: Tue, 11 Feb 2020 16:09:17 -0800 Subject: [PATCH 2/5] fix localized links --- docs/Readme.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/Readme.md b/docs/Readme.md index adbdaca9bf..334d7cbe74 100644 --- a/docs/Readme.md +++ b/docs/Readme.md @@ -69,8 +69,8 @@ of the documentation to one language (Chinese), but we hope to continue translating more pages and to other languages. Consequently, we welcome any enhancements and improvements from the community. -* [Chinese](docs/localized/zh-CN/) -* [Korean](docs/localized/KR/) +* [Chinese](localized/zh-CN/) +* [Korean](localized/KR/) ## Deprecated Docs We no longer use them ourselves and so they may not be up-to-date. From 4b5b1c8cdceb1ffd1fadc7bbe390d36dff81ec01 Mon Sep 17 00:00:00 2001 From: Chris Elion Date: Wed, 12 Feb 2020 11:39:14 -0800 Subject: [PATCH 3/5] previous releases --- README.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/README.md b/README.md index 4149a1f3b3..5fd65de8e7 100644 --- a/README.md +++ b/README.md @@ -93,6 +93,25 @@ to improve and grow. Please take a few minutes to [let us know about it](https:/ For any other questions or feedback, connect directly with the ML-Agents team at ml-agents@unity3d.com. +## Releases +The current version of the release is 0.14.0. Previous releases can be found below: + +| **Version** | **Source** | **Documentation** | **Download** | +|:-------:|:------:|:-------------:|:-------:| +| **0.13.1** | [source](https://github.com/Unity-Technologies/ml-agents/tree/0.13.1) | [docs](https://github.com/Unity-Technologies/ml-agents/tree/0.13.1/docs) | [download](https://github.com/Unity-Technologies/ml-agents/archive/0.13.1.zip) | +| **0.13.0** | [source](https://github.com/Unity-Technologies/ml-agents/tree/0.13.0) | [docs](https://github.com/Unity-Technologies/ml-agents/tree/0.13.0/docs) | [download](https://github.com/Unity-Technologies/ml-agents/archive/0.13.0.zip) | +| **0.12.1** | [source](https://github.com/Unity-Technologies/ml-agents/tree/0.12.1) | [docs](https://github.com/Unity-Technologies/ml-agents/tree/0.12.1/docs) | [download](https://github.com/Unity-Technologies/ml-agents/archive/0.12.1.zip) | +| **0.12.0** | [source](https://github.com/Unity-Technologies/ml-agents/tree/0.12.0) | [docs](https://github.com/Unity-Technologies/ml-agents/tree/0.12.0/docs) | [download](https://github.com/Unity-Technologies/ml-agents/archive/0.12.0.zip) | +| **0.11.0** | [source](https://github.com/Unity-Technologies/ml-agents/tree/0.11.0) | [docs](https://github.com/Unity-Technologies/ml-agents/tree/0.11.0/docs) | [download](https://github.com/Unity-Technologies/ml-agents/archive/0.11.0.zip) | +| **0.10.1** | [source](https://github.com/Unity-Technologies/ml-agents/tree/0.10.1) | [docs](https://github.com/Unity-Technologies/ml-agents/tree/0.10.1/docs) | [download](https://github.com/Unity-Technologies/ml-agents/archive/0.10.1.zip) | +| **0.10.0** | [source](https://github.com/Unity-Technologies/ml-agents/tree/0.10.0) | [docs](https://github.com/Unity-Technologies/ml-agents/tree/0.10.0/docs) | [download](https://github.com/Unity-Technologies/ml-agents/archive/0.10.0.zip) | + +See the [GitHub releases](https://github.com/Unity-Technologies/ml-agents/releases) for more details of the changes +between versions. + +Please note that the `master` branch is under active development, so the documentation there may differ from the code +of a previous release. Always use the documentation that corresponds to the release version you're using. + ## License [Apache License 2.0](LICENSE) From 7e5043a588ae95b9be954da345c186fedc78d829 Mon Sep 17 00:00:00 2001 From: Chris Elion Date: Wed, 12 Feb 2020 11:40:47 -0800 Subject: [PATCH 4/5] change wording --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 5fd65de8e7..2a5632d710 100644 --- a/README.md +++ b/README.md @@ -94,7 +94,7 @@ For any other questions or feedback, connect directly with the ML-Agents team at ml-agents@unity3d.com. ## Releases -The current version of the release is 0.14.0. Previous releases can be found below: +The latest release is 0.14.0. Previous releases can be found below: | **Version** | **Source** | **Documentation** | **Download** | |:-------:|:------:|:-------------:|:-------:| From 95bfff1b7db720f494a3f2dff6330ec7be320511 Mon Sep 17 00:00:00 2001 From: Chris Elion Date: Wed, 12 Feb 2020 11:49:20 -0800 Subject: [PATCH 5/5] script to make the table --- utils/make_readme_table.py | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 utils/make_readme_table.py diff --git a/utils/make_readme_table.py b/utils/make_readme_table.py new file mode 100644 index 0000000000..5a83b7553a --- /dev/null +++ b/utils/make_readme_table.py @@ -0,0 +1,17 @@ +""" +Generate the "Releases" table on the main readme. Update the versions lists, run this script, and copy the output +into the markdown file. +""" +from distutils.version import LooseVersion + + +def table_line(version): + return f"| **{version}** | [source](https://github.com/Unity-Technologies/ml-agents/tree/{version}) | [docs](https://github.com/Unity-Technologies/ml-agents/tree/{version}/docs) | [download](https://github.com/Unity-Technologies/ml-agents/archive/{version}.zip) |" # noqa + + +versions = ["0.10.0", "0.10.1", "0.11.0", "0.12.0", "0.12.1", "0.13.0", "0.13.1"] + +sorted_versions = sorted((LooseVersion(v) for v in versions), reverse=True) + +for v in sorted_versions: + print(table_line(str(v)))