diff --git a/docs/src/core-concepts.md b/docs/src/core-concepts.md
index c13da9e79a..b07db8189f 100644
--- a/docs/src/core-concepts.md
+++ b/docs/src/core-concepts.md
@@ -4,7 +4,7 @@ title: "Core concepts"
 ---
 
 Playwright provides a set of APIs to automate Chromium, Firefox and WebKit
-browsers. By using the Playwright API, you can write JavaScript code to create
+browsers. By using the Playwright API, you can write scripts to create
 new browser pages, navigate to URLs and then interact with elements on a page.
 
 Along with a test runner Playwright can be used to automate user interactions to
diff --git a/docs/src/debug.md b/docs/src/debug.md
index ab0320d004..9a66b02246 100644
--- a/docs/src/debug.md
+++ b/docs/src/debug.md
@@ -12,7 +12,7 @@ for browser automation.
 ## Run in headful mode
 
 Playwright runs browsers in headless mode by default. To change this behavior,
-use `headless: false` as a launch option. You can also use the `slowMo` option
+use `headless: false` as a launch option. You can also use the [`option: slowMo`] option
 to slow down execution and follow along while debugging.
 
 ```js
diff --git a/docs/src/intro-python.md b/docs/src/intro-python.md
index 35f80b5d3d..9c30b0a927 100644
--- a/docs/src/intro-python.md
+++ b/docs/src/intro-python.md
@@ -63,7 +63,7 @@ with sync_playwright() as p:
     browser.close()
 ```
 
-By default, Playwright runs the browsers in headless mode. To see the browser UI, pass the `headless=False` flag while launching the browser. You can also use `slowMo` to slow down execution. Learn more in the debugging tools [section](./debug.md).
+By default, Playwright runs the browsers in headless mode. To see the browser UI, pass the `headless=False` flag while launching the browser. You can also use [`option: slowMo`] to slow down execution. Learn more in the debugging tools [section](./debug.md).
 
 ```py
 firefox.launch(headless=False, slowMo=50)