diff --git a/DECLARATIVE-README.md b/DECLARATIVE-README.md
new file mode 100644
index 000000000..2bc9afbf2
--- /dev/null
+++ b/DECLARATIVE-README.md
@@ -0,0 +1,51 @@
+# Declarative Gradle DSL
+
+This branch has been modified to work with the prototype of the Declarative Gradle DSL.
+
+## Feedback on basics
+
+- "Hybrid" mode where some projects can use declarative files and some do not
+- Ecosystem plugin in settings file and software type in declarative project file
+- Importable and buildable (e.g., gradle build works)
+- Syntax highlighting available in Android Studio
+- Demonstrate NowInAndroid has at least one project file converted
+
+## Setup
+
+```
+git clone https://github.com/gradle/nowinandroid.git
+cd nowinandroid
+git clone https://github.com/gradle/declarative-gradle.git
+```
+
+This should checkout the `main` branch of [declarative-gradle](https://github.com/gradle/declarative-gradle) inside the **root** of a NowInAndroid fork.
+
+```
+nowinandroid/
+    declarative-gradle/
+```
+
+### Building the project
+
+You can assemble the project with the following command:
+
+```shell
+./gradlew buildDemoDebug
+```
+
+### Running tests
+**Note:** See the note in [Screenshot tests](#screenshot-tests) about setting up Roborazzi for non-Linux test runs.
+
+```shell
+./gradlew testDemoDebug :lint:test
+```
+
+```shell
+./gradlew testDemoDebugUnitTest -Proborazzi.test.verify=false
+```
+
+After starting a local Android emulator in Android Studio:
+```shell
+./gradlew connectedDemoDebugAndroidTest --daemon
+````
+
diff --git a/README.md b/README.md
index 1e8238ed2..be1270b16 100644
--- a/README.md
+++ b/README.md
@@ -1,38 +1,3 @@
-# Declarative Gradle DSL
-
-This branch has been modified to work with the prototype of the Declarative Gradle DSL.
-
-## Running
-
-First, checkout `main` branch of the [declarative-gradle](https://github.com/gradle/declarative-gradle) project into the **root** of this project:
-
-```
-  nowinandroid/
-    declarative-gradle/
-```
-
-then run the following command in the `nowinandroid` directory to build the project:
-
-```shell
-./gradlew buildDemoDebug
-```
-
-### Running tests
-**Note:** See the note in [Screenshot tests](#screenshot-tests) about setting up Roborazzi for non-Linux test runs.
-
-```shell
-./gradlew testDemoDebug :lint:test
-```
-
-```shell
-./gradlew testDemoDebugUnitTest -Proborazzi.test.verify=false
-```
-
-After starting a local Android emulator in Android Studio:
-```shell
-./gradlew connectedDemoDebugAndroidTest --daemon
-````
-
 ![Now in Android](docs/images/nia-splash.jpg "Now in Android")
 
 <a href="https://play.google.com/store/apps/details?id=com.google.samples.apps.nowinandroid"><img src="https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png" height="70"></a>