diff --git a/docs/src/intro-js.md b/docs/src/intro-js.md
index 5fc6bb963b..4736a1dcbf 100644
--- a/docs/src/intro-js.md
+++ b/docs/src/intro-js.md
@@ -4,6 +4,7 @@ title: "Getting Started"
 ---
 
 <!-- TOC -->
+- [Release notes](./release-notes.md)
 
 ## Installation
 
diff --git a/docs/src/intro-python.md b/docs/src/intro-python.md
index 9c30b0a927..cb7bda3c86 100644
--- a/docs/src/intro-python.md
+++ b/docs/src/intro-python.md
@@ -4,6 +4,7 @@ title: "Getting Started"
 ---
 
 <!-- TOC -->
+- [Release notes](./release-notes.md)
 
 ## Installation
 
diff --git a/docs/src/release-notes.md b/docs/src/release-notes.md
new file mode 100644
index 0000000000..458c53e74f
--- /dev/null
+++ b/docs/src/release-notes.md
@@ -0,0 +1,60 @@
+---
+id: release-notes
+title: "Release notes"
+---
+
+<!-- TOC -->
+
+## Version 1.8
+
+- [Selecting elements based on layout](./selectors.md#selecting-elements-based-on-layout) with `:left-of()`, `:right-of()`, `:above()` and `:below()`.
+- Playwright now includes [command line interface](./cli.md), former playwright-cli.
+  ```sh js
+  $ npx playwright --help
+  ```
+  ```sh python
+  $ python -m playwright --help
+  ```
+- [`method: Page.selectOption`] now waits for the options to be present.
+- New methods to [assert element state](./actionability#assertions) like [`method: Page.isEditable`].
+
+#### New APIs
+
+- [`method: ElementHandle.isChecked`].
+- [`method: ElementHandle.isDisabled`].
+- [`method: ElementHandle.isEditable`].
+- [`method: ElementHandle.isEnabled`].
+- [`method: ElementHandle.isHidden`].
+- [`method: ElementHandle.isVisible`].
+- [`method: Page.isChecked`].
+- [`method: Page.isDisabled`].
+- [`method: Page.isEditable`].
+- [`method: Page.isEnabled`].
+- [`method: Page.isHidden`].
+- [`method: Page.isVisible`].
+- New option `'editable'` in [`method: ElementHandle.waitForElementState`].
+
+#### Browser Versions
+
+- Chromium 90.0.4392.0
+- Mozilla Firefox 85.0b5
+- WebKit 14.1
+
+## Version 1.7
+
+- **New Java SDK**: [Playwright for Java](https://github.com/microsoft/playwright-java) is now on par with [JavaScript](https://github.com/microsoft/playwright), [Python](https://github.com/microsoft/playwright-python) and [C# bindings](https://github.com/microsoft/playwright-sharp).
+- **Browser storage API**: New convenience APIs to save and load browser storage state (cookies, local storage) to simplify automation scenarios with authentication.
+- **New CSS selectors**: We heard your feedback for more flexible selectors and have revamped the selectors implementation. Playwright 1.7 introduces [new CSS extensions](./selectors.md) and there's more coming soon.
+- **New website**: The docs website at [playwright.dev](https://playwright.dev/) has been updated and is now built with [Docusaurus](https://v2.docusaurus.io/).
+- **Support for Apple Silicon**: Playwright browser binaries for WebKit and Chromium are now built for Apple Silicon.
+
+#### New APIs
+
+- [`method: BrowserContext.storageState`] to get current state for later reuse.
+- `storageState` option in [`method: Browser.newContext`] and [`method: Browser.newPage`] to setup browser context state.
+
+#### Browser Versions
+
+- Chromium 89.0.4344.0
+- Mozilla Firefox 84.0b9
+- WebKit 14.1
diff --git a/docs/src/why-playwright.md b/docs/src/why-playwright.md
index ff83afd9bd..4d79c60953 100644
--- a/docs/src/why-playwright.md
+++ b/docs/src/why-playwright.md
@@ -6,6 +6,7 @@ title: "Why Playwright?"
 Playwright enables fast, reliable and capable automation across all modern browsers. This guide covers those key differentiators to help you decide on the right tool for your automated tests.
 
 <!-- TOC -->
+- [Release notes](./release-notes.md)
 
 ## Support for all browsers
 * **Test on Chromium, Firefox and WebKit**. Playwright has full API coverage for all modern browsers, including Google Chrome and Microsoft Edge (with [Chromium](https://www.chromium.org/)), Apple Safari (with [WebKit](https://webkit.org/)) and Mozilla Firefox.