Merge 53b0242 into 8f15261

README.md

@@ -93,8 +93,8 @@ also be asked to sign a
 To build & edit the docs, first install all necessary dependencies:
 
 ```
-brew install sphinx
 pip3 install -r requirements-dev.txt
+pip3 install -r requirements-docs.txt
 ```
 
 After the installation has finished, you can run and view the documentation

docs/core/actions.rst

@@ -84,15 +84,24 @@ The only thing your action server needs to install is ``rasa-sdk``:
     create a separate container for your action server. In this
     separate container, you only need to install ``rasa-sdk``.
 
-If your actions are defined in a file
-called ``actions.py``, run this command:
+The file that contains your custom actions should be called ``actions.py``.
+
+If you have ``rasa`` installed, run this command to start your action server:
 
 .. code-block:: bash
 
-    python -m rasa_sdk --actions actions
+    rasa run actions
 
 .. _custom_action_example:
 
+Otherwise, if you do not have ``rasa`` installed, run this command:
+
+.. code-block:: bash
+
+    python -m rasa_sdk --actions actions
+
+.. _custom_action_example_verbose:
+
 In a restaurant bot, if the user says "show me a Mexican restaurant",
 your bot could execute the action ``ActionCheckRestaurants``,
 which might look like this: