diff --git a/DECLARATIVE-README.md b/DECLARATIVE-README.md
index a45899a8c..a3e096bea 100644
--- a/DECLARATIVE-README.md
+++ b/DECLARATIVE-README.md
@@ -46,7 +46,7 @@ You can assemble the project with the following command:
 ```
 
 ### Running tests
-**Note:** See the note in [Screenshot tests](README.md#screenshot-tests) about setting up Roborazzi for non-Linux test runs.
+**Note:** See the note in [Screenshot tests](README.md#screenshot-tests) about setting up Roborazzi for non-Linux test runs. You may need to run `recordRoborazziDemoDebug` to regenerate screenshots that will work on your machine.
 
 ```shell
 ./gradlew testDemoDebug :lint:test
@@ -61,3 +61,9 @@ After starting a local Android emulator in Android Studio:
 ./gradlew connectedDemoDebugAndroidTest --daemon
 ````
 
+### IDE editing
+
+Syntax highlighting should work in Android Studio nightlies that understand Gradle DCL files.
+
+Code completion and content assist is currently unsupported.
+