diff --git a/source/_integrations/python_script.markdown b/source/_integrations/python_script.markdown
index da46b52ff62..6a6312129e0 100644
--- a/source/_integrations/python_script.markdown
+++ b/source/_integrations/python_script.markdown
@@ -76,12 +76,13 @@ The above `python_script` can be called using the following YAML as an input.
 
 ## Documenting your Python scripts
 
-You can add descriptions for your Python scripts that will be shown in the Call Services tab of the Developer Options page. To do so, simply create a `services.yaml` file in your `<config>/python_scripts` folder. Using the above Python script as an example, the `services.yaml` file would look like:
+You can add names and descriptions for your Python scripts that will be shown in the frontend. To do so, simply create a `services.yaml` file in your `<config>/python_scripts` folder. Using the above Python script as an example, the `services.yaml` file would look like:
 
 ```yaml
 # services.yaml
 turn_on_light:
-  description: Turn on a light and set its color.
+  name: Turn on light
+  description: Turn on a specific light and set its color.
   fields:
     entity_id:
       description: The light that will be turned on.