diff --git a/docs/API-Reference.md b/docs/API-Reference.md
new file mode 100644
index 0000000000..8562bc6525
--- /dev/null
+++ b/docs/API-Reference.md
@@ -0,0 +1,22 @@
+# API Reference
+
+Our developer-facing C# classes (Academy, Agent, Decision and
+Monitor) have been documented to be compatabile with
+[Doxygen](http://www.stack.nl/~dimitri/doxygen/) for auto-generating HTML
+documentation.
+
+To generate the API reference,
+[download Doxygen](http://www.stack.nl/~dimitri/doxygen/download.html) and run
+the following command within the `docs/` directory:
+
+ doxygen dox-ml-agents.conf
+
+`dox-ml-agents.conf` is a Doxygen configuration file for ML-Agents
+that includes the classes that have been properly formatted.
+The generated HTML files will be placed
+in the `html/` subdirectory. Open `index.html` within that subdirectory to
+navigate to the API reference home. Note that `html/` is already included in
+the repository's `.gitignore` file.
+
+In the near future, we aim to expand our documentation
+to include all the Unity C# classes and Python API.
diff --git a/docs/Readme.md b/docs/Readme.md
index e722f81c86..94d8daf974 100644
--- a/docs/Readme.md
+++ b/docs/Readme.md
@@ -35,12 +35,6 @@
* [ML-Agents Glossary](Glossary.md)
* [Limitations & Common Issues](Limitations-and-Common-Issues.md)
-## C# API and Components
- * Academy
- * Agent
- * Decision
- * Monitor
-
-## Python API
+## API Docs
+ * [API Reference](API-Reference.md)
* [How to use the Python API](Python-API.md)
-
\ No newline at end of file
diff --git a/docs/dox-ml-agents.conf b/docs/dox-ml-agents.conf
index 7119459efb..439c5f0bbc 100644
--- a/docs/dox-ml-agents.conf
+++ b/docs/dox-ml-agents.conf
@@ -31,7 +31,7 @@ PROJECT_NAME = "ML-Agents"
# could be handy for archiving the generated documentation or if some version
# control system is used.
-PROJECT_NUMBER = v0.2
+PROJECT_NUMBER = v0.3
# Using the PROJECT_BRIEF tag one can provide an optional one line description
# for a project that appears at the top of each page and should give viewer a
@@ -783,33 +783,10 @@ WARN_LOGFILE =
# spaces. See also FILE_PATTERNS and EXTENSION_MAPPING
# Note: If this tag is empty the current directory is searched.
-INPUT = ML-Agents-Overview.md \
- Background-Unity.md \
- Background-Machine-Learning.md \
- Background-TensorFlow.md \
- Installation.md \
- Installation-Docker.md \
- Background-Jupyter.md \
- Getting-Started-with-Balance-Ball.md \
- Learning-Environment-Examples.md \
- Learning-Environment-Create-New.md \
- Learning-Environment-Design.md \
- Learning-Environment-Design-Agents.md \
- Learning-Environment-Design-Academy.md \
- Learning-Environment-Design-Brains.md \
- Training-ML-Agents.md \
- Training-PPO.md \
- Training-Curriculum-Learning.md \
- Training-Imitation-Learning.md \
- Using-TensorFlow-Sharp-in-Unity.md \
- Training-on-Amazon-Web-Service.md \
- Using-Tensorboard.md \
- Python-API.md \
- Feature-Broadcasting.md \
- Feature-Monitor.md \
- Limitations-and-Common-Issues.md \
- ../unity-environment/Assets/ML-Agents/Scripts \
- ../python/unityagents
+INPUT = ../unity-environment/Assets/ML-Agents/Scripts/Academy.cs \
+ ../unity-environment/Assets/ML-Agents/Scripts/Agent.cs \
+ ../unity-environment/Assets/ML-Agents/Scripts/Monitor.cs \
+ ../unity-environment/Assets/ML-Agents/Scripts/Decision.cs
# This tag can be used to specify the character encoding of the source files
# that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses
diff --git a/docs/doxygen/Readme.md b/docs/doxygen/Readme.md
index 7755c618da..b92b864e14 100644
--- a/docs/doxygen/Readme.md
+++ b/docs/doxygen/Readme.md
@@ -2,4 +2,4 @@
To generate the API reference as HTML files, run:
- doxygen ml-agents.conf
+ doxygen dox-ml-agents.conf
diff --git a/unity-environment/Assets/ML-Agents/Scripts/Agent.cs b/unity-environment/Assets/ML-Agents/Scripts/Agent.cs
index 4bfe55a2b2..d829de0e55 100755
--- a/unity-environment/Assets/ML-Agents/Scripts/Agent.cs
+++ b/unity-environment/Assets/ML-Agents/Scripts/Agent.cs
@@ -118,14 +118,14 @@ public class AgentParameters
public bool resetOnDone = true;
///
- /// Whether to enable On Demand Decision Making or make a decision at
+ /// Whether to enable On Demand Decisions or make a decision at
/// every step.
///
public bool onDemandDecision;
///
- /// Number of actions between decisions (used when On Demand Decision
- /// Making is turned off).
+ /// Number of actions between decisions (used when On Demand Decisions
+ /// is turned off).
///
public int numberOfActionsBetweenDecisions;
}
@@ -237,7 +237,7 @@ public abstract class Agent : MonoBehaviour
int stepCount;
// Flag to signify that an agent has been reset but the fact that it is
- // done has not been communicated (required for On Demand Decision Making).
+ // done has not been communicated (required for On Demand Decisions).
bool hasAlreadyReset;
// Flag to signify that an agent is done and should not reset until
diff --git a/unity-environment/Assets/ML-Agents/Scripts/CoreBrainHeuristic.cs b/unity-environment/Assets/ML-Agents/Scripts/CoreBrainHeuristic.cs
index bf0f2e1625..5630d66d4a 100755
--- a/unity-environment/Assets/ML-Agents/Scripts/CoreBrainHeuristic.cs
+++ b/unity-environment/Assets/ML-Agents/Scripts/CoreBrainHeuristic.cs
@@ -6,7 +6,7 @@
using UnityEditor;
#endif
-/// CoreBrain which decides actions using developer-provided Decision.cs script.
+/// CoreBrain which decides actions using developer-provided Decision script.
public class CoreBrainHeuristic : ScriptableObject, CoreBrain
{
[SerializeField]