diff --git a/README.md b/README.md
index b393571..cd943c4 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,11 @@
-
Still Alive
-A JavaScript implementation of the end credits from the video game Portal
+
+Still Alive
+The end credits song from the video game Portal
done with pure JavaScript, browser windows, and a lot of patience.
Take me to the demo 🍰
+
+Known limitations
+
+ - Time drifting
The browser will throttle setTimeout()
when it deems a page as low-priority (running in the background etc.). This will cause all visuals to fall behind the music and appear as delayed.
+ - Windows blocked
Pop-up blockers (built-in on most browsers) will prevent all- or some windows to open. You have to allow the page to "open multiple windows" in your browser for this demo to work.
+ - Stacking windows on Chrome for Windows (the OS)
Due to a bug in Chromium on Windows, browser windows will stack if the play button is clicked from a non-primary display.
+